Conecta con nosotros

Hola, ¿qué estás buscando?

Actualidad

Vuelve Season of Docs, el programa de Google para mejorar la documentación de proyectos de código abierto

Season Of Docs

Season Of Docs

Google ha anunciado Season of Docs 2020, la vuelta del programa que lanzaron el año pasado con el objetivo de mejorar la documentación de proyectos de código abierto, uno de los aspectos más susceptibles de crítica en este segmento, y que se saldó con 44 proyectos de documentación exitosos.

Si arrancábamos el día hablando de documentos, formatos y estándares libres, pasamos ahora a hacerlo de documentación de proyectos de código abierto, cuya mejora y mantenimiento es indispensable para su adopción y expansión. La falta de documentación completa y de calidad es una de las quejas más comunes que tienen las organizaciones y desarrolladores para apostar por la implementación de software de código abierto.

Así lo reflejan las encuestas que se realizan en torno a este asunto, según recoge Google: muchos desarrolladores reconocen que «las políticas y la documentación establecidas» es un factor de decisión clave», mientras que muchos más acusan «la documentación incompleta u obsoleta como un problema generalizado». De hecho, «la razón principal por la cual los desarrolladores decidieron no usar un proyecto de código abierto es la falta de documentación», señalan.

Con el objetivo de mejorar esta situación, Google lanzó el año pasado Season of Docs, una iniciativa a la que no puede sumarse cualquier: buscan escritores técnicos con experiencia, pues es necesario saber «cómo escribir documentos que se ajustan a las necesidades de su audiencia, cómo estructurar un sitio de documentación y cómo ayudar a optimizar los procesos de contribución». Por supuesto, no se trata de recabar interesados por el amor al arte y los escogidos cobrarán por su trabajo.

«Season of Docs reúne a proyectos de código abierto y escritores técnicos con el objetivo compartido de crear documentación de calidad. Los escritores aportan su experiencia a los proyectos, y los mentores del proyecto ayudan a los escritores a aprender más sobre el código abierto y las nuevas tecnologías. Las comunidades obtienen nuevos contribuyentes y los escritores obtienen valiosas habilidades de código abierto.

Juntos, los escritores y mentores técnicos crean un nuevo conjunto de documentación, mejoran la estructura de la ya existente, desarrollan tutoriales necesarios o mejoran los procesos y guías de contribución.

Al trabajar juntos en Season of Docs, creamos conciencia sobre el código abierto, los documentos y la escritura técnica.»

Advertencia, desplázate para continuar leyendo

1 comentario

Te recomendamos

Actualidad

El pasado 28 de abril de 2011 llegaba al mercado la versión final de Ubuntu 11.04 Natty Narwhal, una distribución que ya de por...

Actualidad

Hace menos de seis meses que publiqué el extenso análisis de Ubuntu 11.04, y en aquella ocasión dejé claras mis impresiones: Unity había provocado...

Actualidad

Ciertamente, tener a Linux en las escuelas o, dicho con más propiedad, tener a GNU/Linux en las escuelas, no debería ser una pregunta abierta...

Actualidad

Nos encontramos al fin ante Fedora 14, la última versión de la distribución comunitaria de Red Hat, y lo hacemos con un análisis detallado...