La documentación se desvía cuando vive en otro sitio
Un repositorio de documentación aparte es la promesa de actualizar dos sitios. El segundo pierde siempre. El resultado es documentación segura de sí misma y equivocada, que es peor que no tener documentación.
Dónde viven las docs
Cada producto lleva su carpeta src/content/docs/ dentro de su propia app. El
pull request que cambia una funcionalidad cambia su documentación en el mismo
commit — el único mecanismo que de verdad mantiene honestas las docs.
Este sitio lee todas esas carpetas en build y las publica bajo un mismo techo, con un único índice de búsqueda sobre todos los productos y la plataforma.
Las secciones vacías son a propósito
Algunos productos llegan con poca documentación o con ninguna. Esas secciones aparecen vacías en vez de ocultarse: un hueco visible es un recordatorio, y esconderlo solo haría parecer las aplicaciones más terminadas de lo que están.