¡Te damos la bienvenida a la temporada de Documentos!
Fomenta la colaboración de código abierto con escritores técnicos
Fase actual:
La temporada de Documentos del programa 2019 finalizó el 6 de marzo de 2020. Consulta el cronograma.
El objetivo de Season of Docs es proporcionar un framework para que los escritores técnicos y los proyectos de código abierto trabajen juntos con el objetivo común de mejorar la documentación de un proyecto de código abierto. Para los escritores técnicos que son nuevos en el código abierto, el programa ofrece la oportunidad de adquirir experiencia en la contribución a proyectos de código abierto. Para los escritores técnicos que ya trabajan en el código abierto, el programa ofrece una posible manera nueva de trabajar juntos. Season of Docs también les da a los proyectos de código abierto la oportunidad de involucrar a más miembros de la comunidad de escritura técnica.
Durante el programa, los escritores técnicos pasan algunos meses trabajando en estrecha colaboración con una comunidad de código abierto. Incorpora su experiencia en escritura técnica a la documentación del proyecto y, al mismo tiempo, aprende sobre el proyecto de código abierto y las nuevas tecnologías.
Los proyectos de código abierto trabajan con los escritores técnicos para mejorar la documentación y los procesos del proyecto. Juntos pueden optar por crear un nuevo conjunto de documentación o rediseñar los documentos existentes, o mejorar y documentar los procedimientos de contribución y la experiencia de integración de la comunidad de código abierto.
Juntos, fomentamos la concienciación pública sobre los documentos de código abierto, la escritura técnica y la manera en que podemos trabajar juntos en beneficio de la comunidad global de código abierto.
¿Cómo funciona?
Este es el flujo de trabajo general del programa Temporada de Documentos:
Las organizaciones de código abierto se postulan para ser organizaciones de mentor en la temporada de Documentos de este año. Pueden enviar una lista de ideas de proyectos de documentación con sus solicitudes.
Los escritores técnicos exploran la lista de organizaciones participantes y eligen los proyectos que les interesan. Un escritor técnico puede comunicarse con las organizaciones relevantes para hablar sobre sus ideas. Luego, el escritor técnico redacta una propuesta de proyecto y la envía a Season of Docs.
Las organizaciones confirman los proyectos de escritura técnica que desean supervisar.
Los escritores técnicos aceptados pasan algunos meses trabajando con mentores de organizaciones de código abierto para completar sus proyectos.
Al final del programa, los administradores del programa de Google anuncian los proyectos que finalizaron con éxito.
En el cronograma, se muestran los detalles de los pasos involucrados y las fechas clave.
Participantes y funciones
A continuación, se muestran los grupos principales de personas que participan en Season of Docs y la función que cada grupo desempeña en el programa:
Los administradores de la organización son miembros de las organizaciones de código abierto participantes que actúan como el contacto principal de la temporada de Documentos para su organización. Los administradores de la organización envían la solicitud de la organización para participar en Season of Docs, gestionar a los mentores dentro de sus organizaciones, asegurarse de que los proyectos de redacción técnica se mantengan encaminados, manejar el papeleo y gestionar la distribución del subsidio de mentores. Consulta la guía y las responsabilidades del administrador.
Los mentores de código abierto son miembros de las organizaciones de código abierto participantes que se aceptan como mentores para la temporada de Documentos de este año. Los mentores trabajan en estrecha colaboración con los escritores técnicos para ayudar a garantizar un proyecto exitoso. Consulta la guía y las responsabilidades para mentores.
Los Escritores técnicos son escritores técnicos de todo el mundo y están aceptados para participar en la temporada de Documentos de este año. Los postulantes deben poder demostrar experiencia previa en la escritura técnica mediante el envío de descripciones de funciones y muestras de trabajo. Consulta la guía y las responsabilidades del escritor técnico.
Los administradores del programa de Google son administradores de programas dentro de Google que ejecutan el programa Season of Docs.
Próximos pasos
- Únete a la lista de distribución de anuncios en season-of-docs-announce para mantenerte al tanto de cuándo se abren las solicitudes y otros eventos importantes del programa.
- Revisa el cronograma para conocer los hitos y las fechas importantes.
- Para comenzar, regístrate como participante, ya seas escritor técnico o miembro de un proyecto de código abierto.
- Lee las Preguntas frecuentes si tienes alguna duda.
- Comunícate con nosotros si necesitas más ayuda o deseas unirte a los debates.