Descrição dos campos retornados pela API do Discourse

Isso é compreensível. Há um código semelhante, no entanto. Ele está aqui: discourse/app/models/post.rb at main · discourse/discourse · GitHub. A estrutura do banco de dados do Discourse é muito consistente. Espero que isso ajude a compensar a falta de documentação.

Não tenho certeza de que cada campo retornado pela API será documentado, mas documentar os vários locais onde códigos numéricos são retornados parece importante. Exemplos disso são:

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

Se formos em frente com isso, não tenho certeza de qual seria o melhor local para a documentação. Possivelmente em https://docs.discourse.org/, mas é possível que haja problemas técnicos ao fazer isso.