¿Puedes aclarar un poco más a qué te refieres con esto?
Si bien el punto de Simon sobre que estos no cubren las API implementadas por extensiones de Discourse (por ejemplo, plugins), esta documentación es oficial en el sentido de que la mantenemos.
Eso no quiere decir que no tengamos bastante margen de mejora en cuanto a la documentación de la API del lado del servidor y la API en sí, pero sí quería entender un poco mejor tus comentarios sobre la documentación que ya existe.