Basic Product Documentation

Я не могу говорить от имени discourse.org, но я так не думаю, потому что https://docs.discourse.org — это документация по API Discourse для разработчиков. Эти ссылки предназначены для других целей.

Кстати, использование этих ссылок без понятной подписи — довольно бесполезное поведение.

Документацию можно улучшить, но это огромная работа для постоянно меняющегося продукта с открытым исходным кодом.

Если вы посмотрите на категорию howto, то увидите разнообразие интересов, которые невозможно охватить в одном документе:

  • #howto:devs
  • #howto:sysadmin
  • #howto:admins
  • #howto:cmgrs (менеджеры сообществ)
  • #howto:faq, #howto:tips-and-tricks для всех

Также существует огромное количество пересечений в темах, и это очень очевидно в других категориях, влияющих на пользовательский опыт:

2 лайка