Это понятно. Однако аналогичный код существует. Он находится здесь: discourse/app/models/post.rb at main · discourse/discourse · GitHub. Структура базы данных Discourse очень последовательна. Надеюсь, это поможет компенсировать отсутствие документации.
Не уверен, что каждое поле, возвращаемое API, будет задокументировано, но документирование различных мест, где возвращаются числовые коды, кажется важным. Примерами этого являются:
Post.typesUserAction.typesNotification.typesNotificationLevels.allUserOption.email_level_types
Если мы решим это сделать, я не уверен, где лучше всего разместить документацию. Возможно, на https://docs.discourse.org/, но могут возникнуть технические сложности с такой реализацией.