# ¿Por qué no está completamente documentada la API de Discourse?

**URL:** <https://meta.discourse.org/t/why-isnt-the-discourse-api-fully-documented/138265>\
**Category:** Development\
**Created:** [10 Enero, 2020 19:22 UTC](https://meta.discourse.org/t/why-isnt-the-discourse-api-fully-documented/138265 "2020-01-10T19:22:16Z")\
**Posts on this page:** 1\
**Showing post:** 14

<div class="post-metadata">

**Author:** ![jomaxro](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jomaxro/32/126216_2.png) [@jomaxro](https://meta.discourse.org/u/jomaxro)\
**Post date:** [13 Enero, 2020 17:53 UTC](https://meta.discourse.org/t/why-isnt-the-discourse-api-fully-documented/138265/14 "2020-01-13T17:53:55Z")

</div>

> [@samamorgan](#):
>
> Realmente solo me pregunto por qué esto es incluso necesario en un proyecto tan consolidado.

Como en todo, se trata de recursos y prioridades. La superficie de la API es enorme. Técnicamente, lo abarca todo: todo se accede a través de la API, de ahí que funcione la ingeniería inversa. Hemos decidido centrar nuestro tiempo limitado de ingeniería en correcciones, nuevas funciones, rendimiento, etc., en lugar de en la documentación. La dirección de nuestro producto está impulsada en gran medida por nuestros clientes y nuestra comunidad. Que yo sepa, ningún cliente ha solicitado nunca una cobertura del 100 % de la documentación de la API. Cuando los clientes preguntan sobre algo que falta o no está claro, lo añadimos. Por lo tanto, la cobertura del 100 % no ha sido una prioridad.

En este momento, la documentación de la API se elabora manualmente. Obviamente, este no es un método sostenible, pero por ahora es lo que tenemos. La refactorización del sistema de documentación de la API para que se genere programáticamente es una tarea pendiente, pero actualmente no está programada para ninguna versión específica, por lo que no hay un cronograma para su finalización.

---

_[View the full topic](https://meta.discourse.org/t/why-isnt-the-discourse-api-fully-documented/138265)._
