La documentación en el software de código abierto suele ser una tarea relegada, no por falta de interés, sino por la escasez de tiempo y recursos que enfrentan los mantenedores. En respuesta a esta necesidad, Google ha presentado dos recursos que buscan facilitar este trabajo: Docs Advisor y Documentation Project Archetypes. Ambas iniciativas se enfocan en apoyar a quienes gestionan proyectos open source para planificar, escribir y mantener mejor su documentación.¿Qué es Docs Advisor?Imagina tener un redactor técnico experimentado guiándote paso a paso mientras escribes tus manuales. Eso es lo que pretende el Docs Advisor, una guía completa que recoge metodologías y buenas prácticas de la redacción técnica, el diseño centrado en el usuario y la estrategia de contenido.El proceso se divide en cuatro etapas:Definir el enfoque adecuado para el proyecto, según sus características y objetivos.Conocer a la audiencia, entendiendo sus necesidades y cómo la documentación puede ayudarlos de forma directa.Evaluar los recursos disponibles (tiempo, colaboradores, herramientas), para planificar un trabajo realista.Escribir, revisar y mantener los documentos de forma cómoda y efectiva.La guía incluye una plantilla de plan de documentación que ayuda a responder preguntas clave como: ¿qué tipo de documentos necesitamos?, ¿qué riesgos existen en el proceso?, ¿qué pasos deberíamos seguir para asegurar el éxito?Los Documentation Project ArchetypesOtra de las novedades destacadas son los Documentations Project Archetypes, una colección de 13 «arquetipos» que funcionan como guías de campo para distintos tipos de proyectos de documentación. Cada uno está diseñado para identificar problemas frecuentes y sugerir caminos para resolverlos.Los arquetipos se dividen en cuatro categorías principales:Planificación y evaluaciónAyudan a analizar la situación actual, detectar fallos y preparar una estrategia eficaz. Ejemplos: The Audit y The Experiment.Creación de nueva documentaciónPensados para cuando es necesario desarrollar guías o manuales desde cero, como The Guide o The Cookbook.Revisión y transformaciónPara mejorar lo que ya existe, reducir el costo de mantenimiento o llegar a nuevas audiencias. Aquí aparecen arquetipos como The Edit y The Reframe.Herramientas y procesosCúbren el uso de nuevos sistemas o prácticas que optimicen el flujo de trabajo, como The Migration o The Factory.Cada arquetipo incluye ejemplos prácticos y sugerencias de colaboración entre mantenedores, escritores y usuarios.El origen de estas herramientasAmbos recursos nacen de la experiencia acumulada en el programa Google Season of Docs, donde más de 130 proyectos open source documentaron sus avances entre 2019 y 2024. Se generaron más de 200 informes, repletos de casos reales, soluciones creativas y también errores de los que se puede aprender.A partir de ese contenido, Google colaboró con expertos como Daniel Beck y Erin Kissane para convertir esas experiencias en materiales accesibles y reutilizables. Así nacieron el Docs Advisor y los Documentation Project Archetypes, con el objetivo de hacer más accesible y eficiente la mejora de la documentación técnica en el software libre.¿Dónde se pueden consultar?Tanto el Docs Advisor como los arquetipos están disponibles de forma abierta. Los arquetipos se pueden explorar directamente desde GitHub, y Google está promoviendo activamente su uso mediante charlas y talleres, como la presentación de Daniel Beck en FOSDEM 2025 o el podcast API Resilience.Incluso se está trabajando en materiales visuales para facilitar la comprensión, como tarjetas ilustradas de algunos arquetipos (“The Edit”, “The Audit”, “The Factory”), creadas junto a la ilustradora Heather Cummings.Por qué esto importaUna buena documentación puede marcar la diferencia entre un proyecto que crece y uno que se estanca. Para los nuevos usuarios, es la puerta de entrada; para los colaboradores potenciales, es la guía de navegación. Estas nuevas herramientas de Google no prometen soluciones mágicas, pero sí ofrecen estructuras claras y accesibles para mejorar paso a paso, con foco en el impacto real y sostenible.Si eres mantenedor de un proyecto open source y sientes que la documentación es un monstruo difícil de domar, vale la pena echar un vistazo a estas nuevas propuestas. Puedes encontrar más información y participar en su desarrollo en el repositorio Open Docs en GitHub.La noticia Google lanza nuevas herramientas para mejorar la documentación en proyectos open source fue publicada originalmente en Wwwhatsnew.com por Natalia Polo.