Discourse API によって返されるフィールドの説明

それは理解できます。ただし、類似のコードは存在します。こちらをご覧ください:discourse/app/models/post.rb at main · discourse/discourse · GitHub データベースの構造は非常に一貫性があります。ドキュメント不足を補う一助となれば幸いです。

API が返すすべてのフィールドがドキュメント化されるかどうかは確信できませんが、数値コードが返されるさまざまな場所をドキュメント化することは重要だと考えられます。その例としては以下が挙げられます。

  • Post.types
  • UserAction.types
  • Notification.types
  • NotificationLevels.all
  • UserOption.email_level_types

これを進める場合、ドキュメントの最適な場所がどこになるか確信が持てません。おそらく https://docs.discourse.org/ が候補ですが、技術的な問題が発生する可能性もあります。