DevDocs
Los desarrolladores destacan DevDocs.io como un navegador de documentación rápido, unificado y con capacidad sin conexión que aumenta de forma notable la productividad, especialmente con conexiones inestables o en vuelos largos. Lo comparan con herramientas como Dash y Zeal, comentan integraciones con editores y frontends de CLI, y señalan carencias como la ausencia de docs de C# por preocupaciones de licencias. La conversación se amplía hacia la importancia de una documentación sin conexión de fácil acceso para el software libre, las compensaciones en formatos y generadores de documentación, y cómo herramientas emergentes como los LLMs podrían complementar o, con el tiempo, redefinir el consumo de conocimiento técnico.
Sentimiento general y casos de uso
- Muchos comentaristas dicen que han dependido de DevDocs durante años y que lo mantienen fijado o integrado en su flujo de trabajo.
- Se destaca el acceso sin conexión como algo crítico en aviones, con Wi‑Fi inestable y en configuraciones sin distracciones; varios informan que son más productivos sin conexión con DevDocs más herramientas/LLMs locales.
- Algunos desarrolladores dicen que prácticamente no programan sin internet (Google, MDN, ChatGPT), así que las docs sin conexión les parecen menos esenciales.
Comparaciones y alternativas
- Se compara con frecuencia con Dash (macOS) y Zeal (código abierto, multiplataforma); DevDocs se ve como una alternativa abierta y centrada en la web.
- Los usuarios valoran la capacidad de Dash para extraer de ReadTheDocs y de docsets aportados por usuarios; se señala que DevDocs carece de parte de eso.
- Otras herramientas mencionadas: dedoc (CLI para DevDocs), devdocs-desktop, plugins para Vim/Neovim/Emacs, docsets aportados por usuarios en Zeal, navegadores locales como CHM, GNU info, páginas man.
Formatos y estándares de documentación sin conexión
- Debate sobre formatos de empaquetado para docs sin conexión: sitios estáticos en ZIP, Markdown, AsciiDoc, docsets de Dash, GNU info, ePub, CHM.
- Se señalan compromisos: imágenes frente a tamaño, docs por versión, sitios con mucho JS más difíciles de reflejar, y navegadores que abandonan el soporte para algunos formatos.
- Algunos quieren una forma estandarizada, parecida a RSS, de anunciar docs “aptas para sin conexión”; no se identificó ninguna ampliamente adoptada.
Funciones de DevDocs, carencias y problemas técnicos
- Se valora por su velocidad, la búsqueda unificada entre muchas APIs/lenguajes y el modo sin conexión.
- Peticiones para más ecosistemas: C#, Playwright, SDKs móviles/de SO, Common Lisp, confusión con Java (aparece como “OpenJDK”).
- Las docs de C#/.NET están limitadas por supuestos problemas de licencia, aunque otros señalan docs de Microsoft con licencia CC y repositorios de GitHub.
- Quejas: Firefox y algunos navegadores expulsan el almacenamiento sin conexión; los reinicios del almacenamiento local pueden borrar los conjuntos de docs seleccionados.
- El mantenedor explica que las docs se extraen de HTML; los sitios con mucho JS y CSS con nombres aleatorios complican la extracción y la limpieza; los informes de docs desactualizadas se generan mensualmente.
Debate filosófico: docs sin conexión, apertura y LLMs
- Un subhilo largo argumenta que el acceso sin conexión, fácil y a la documentación completa, debería considerarse tan fundamental como la disponibilidad del código en el software libre.
- Otros responden que:
- El problema mayor es la calidad de la documentación, no solo el acceso sin conexión.
- A muchos usuarios les servirán mejor interfaces intuitivas que las docs.
- Los LLMs responden cada vez más preguntas más rápido que las docs tradicionales, lo que podría reducir la importancia a largo plazo de herramientas como DevDocs.