Fase actual:
Desarrollo de la documentación. Consulta el cronograma.
Esta guía está dirigida a los administradores de organizaciones que se postulan al programa Temporada de Documentos de Google o que participen en él.
¿Tu organización debe participar en el programa Temporada de Documentos de Google?
Usa estas preguntas para comprender si tu organización o proyecto de código abierto debe participar en la temporada de Documentos de Google.
Tu organización o proyecto:
- ¿Crees que la documentación nueva o actualizada ayudaría a lograr un objetivo o resolver un problema en tu proyecto o comunidad?
- ¿Tienes una comprensión inicial o una hipótesis sobre cómo medirías el éxito de tu proyecto de documentación?
- ¿Tiene miembros de la comunidad dispuestos a ayudar a reclutar, evaluar e incorporar a un escritor técnico, y quién estaría disponible para responder preguntas y brindarle otro tipo de asistencia durante el proyecto (de 6 a 8 meses, incluido el período de postulación)?
- ¿Tienes un miembro de la comunidad dispuesto a ser el administrador de la organización y coordinar la creación de la solicitud, responder a las preguntas de los administradores del programa y enviar evaluaciones mensuales, además de la evaluación final y el caso práctico? El administrador de la organización también debe estar dispuesto a responder encuestas de seguimiento luego de que finalice el programa Temporada de Documentos de Google.
Tu organización también debe cumplir con los requisitos de elegibilidad del programa, lo que incluye poder crear una cuenta de Open Collective.
El proceso de solicitud de la organización
Fase de exploración
Si bien la temporada de solicitudes de Documentos de Google comienza el 22 de febrero de 2024, sugerimos encarecidamente que las organizaciones se tomen el tiempo para completar los pasos de la fase de exploración antes de enviar su solicitud.
- Crea una página de propuesta de proyecto. La página de propuestas incluye una lista de necesidades, objetivos o problemas clave, posibles soluciones de documentación y posibles métricas. Esta página debe ser pública y permitir contribuciones y debates de la comunidad. Incluye información para los escritores técnicos que quieran participar. ¿Dónde deben hacer preguntas, expresar interés o obtener más información sobre tu proyecto? Te sugerimos que agregues una dirección de correo electrónico para comunicarte con tu organización de código abierto sobre Google Season of Docs. Sin embargo, recomendamos no usar una dirección de correo electrónico personal como dirección de correo electrónico para comunicarte con tu organización de código abierto. (Consulta la lista de ideas de proyectos para obtener ejemplos).
- Publicita la página de tu propuesta en los canales de tu comunidad y agrega tu organización a la lista de organizaciones interesadas en el repositorio de GitHub de la temporada de documentos de Google. También puedes compartir tu vínculo en el canal #season-of-docs de Slack, en Escribe los documentos en Slack. La página de promoción y prensa incluye logotipos y otro contenido que puedes usar cuando te refieras a la temporada de Documentos de Google.
- Para cada idea de documentación, considera qué experiencia y calificaciones necesitaría un escritor técnico para trabajar con éxito con tu comunidad y organización. ¿Qué habilidades podría ayudar a desarrollar tu comunidad a un escritor técnico (por ejemplo, usar GitHub o la cadena de herramientas de documentos)? (Consulta la guía para trabajar con escritores técnicos.
- Pide voluntarios que ayuden a responder las preguntas de los escritores técnicos interesados.
- Comienza a revisar las declaraciones de interés enviadas de escritores técnicos interesados en trabajar con tu proyecto.
Fase de aplicación
- Elige la idea más prometedora de la página de propuestas. Cada organización solo puede enviar una propuesta. Estos son algunos aspectos que debes tener en cuenta:
- ¿Cuál de las siguientes ideas recibió más interés de los escritores técnicos?
- ¿Qué idea te ayudará a resolver el mayor problema de tu proyecto? Es mejor elegir una idea más arriesgada que tenga un mayor impacto que una idea para un proyecto de documentación que tenga más probabilidades de completarse, pero que no marcará una diferencia significativa en tu proyecto.
- ¿La idea requiere la participación de miembros específicos de tu comunidad? ¿Tiene tiempo para participar?
Crea tu propuesta con la plantilla de propuestas. Asegúrate de comprender y de incluir lo siguiente:
- El problema que quieres abordar
- El alcance de la documentación que deseas mejorar o crear
- Cómo medirás el éxito de la documentación
La propuesta también debe incluir un presupuesto. No se pueden considerar propuestas incompletas.
Envía el Formulario de solicitud antes de la fecha límite de solicitud, el 2 de abril de 2024 a las 6:00 p.m. UTC. Las propuestas aceptadas se anunciarán el 10 de abril de 2024.
Desarrollo de proyectos e informes
Reunión inicial del proyecto
- Si tu organización ya seleccionó a uno o varios escritores técnicos para tu proyecto, realiza una reunión inicial con tu redactor técnico. Debe colaborar con su escritor técnico a fin de crear un cronograma para el trabajo y realizar controles periódicos.
- Si recibiste varias declaraciones de interés de escritores técnicos interesados, haz un anuncio público sobre tu selección de escritores técnicos o informa de alguna otra manera a los solicitantes tu decisión.
Otorgar pagos
- A partir del 11 de junio de 2024, Google Season of Docs depositará el 40% de los fondos de la subvención en la cuenta de Open Collective de cada organización. Recomendamos que las organizaciones creen un programa de pagos con escritores técnicos en función de los eventos importantes del proyecto, incluido un pago al inicio del proyecto.
- El 60% restante se depositará en las cuentas de Open Collective de las organizaciones que completan y envían sus evaluaciones finales y casos de éxito, a partir del 13 de diciembre de 2024. Todos los proyectos exitosos comenzarán a recibir el pago final el 13 de diciembre de 2024
- Consulta la guía de pagos para obtener más información sobre cómo crear una cuenta de Open Collective.
Informes de estado del proyecto
- Los administradores de la organización deben completar los informes de estado mensuales en el plazo de una semana después de recibir el vínculo al formulario del informe de estado (el vínculo se enviará por correo electrónico, así que revisa tu carpeta de spam si no lo viste).
Evaluación final del proyecto y caso práctico
Las organizaciones deben completar y enviar la evaluación final del proyecto y el caso de éxito antes del 10 de diciembre de 2024 a las 6:00 p.m. UTC para recibir los fondos subvencionados restantes.
Evaluación final
El formulario de evaluación final estará disponible para los administradores de la organización al menos un mes antes del 10 de diciembre de 2024 a las 6:00 p.m. UTC.
Caso de éxito
El caso de éxito de la temporada de Documentos de Google es el entregable clave de la participación de tu organización en la temporada de Documentos de Google. Llevar un registro semanal de las actualizaciones del proyecto te ayudará a crear tu caso práctico. Para cada semana, registra el progreso del proyecto (incluidos vínculos a solicitudes de extracción, problemas o conversaciones, cuando sea útil), qué salió bien (o no), lo que aprendiste y las preguntas que se hicieron.
Lee cómo crear un caso de éxito para obtener información adicional y asegúrate de seguir nuestra plantilla de casos de éxito a fin de crear tu caso de éxito. Deberás enviar tu caso práctico como vínculo en el formulario de evaluación final.
Tu caso de éxito se publicará en el sitio de la temporada de Documentos de Google, así que tenlo en cuenta cuando incluyas información sobre tu proyecto.
Las organizaciones aceptadas deben participar en al menos tres encuestas de seguimiento para realizar un seguimiento del éxito de los proyectos de Google Season of Docs a lo largo del tiempo.
Formularios
| Forma | Vínculo | Plazos |
|---|---|---|
| Aplicación de la organización | Ya no se pueden enviar postulaciones de la organización. Para estar al tanto, únete a la lista de distribución de anuncios en season-of-docs-announce. |
2 de abril de 2024 a las 6:00 p.m. UTC |
| Información de pago de la organización | 14 de mayo de 2024 a las 6:00 p.m. UTC | |
| Prueba de la contratación de escritor técnico | 22 de mayo de 2024 a las 6:00 p.m. UTC | |
| Evaluaciones mensuales | Formulario disponible durante la fase de evaluación del proyecto (5 de junio de 2024). |
Ver cronogramas |
| Evaluación final del proyecto y caso práctico | Formulario disponible durante la evaluación final del proyecto y la fase de caso de éxito (del 22 de noviembre de 2024 al 10 de diciembre de 2024). |
10 de diciembre de 2024 a las 6:00 p.m. UTC |
| Encuestas de seguimiento | Formulario disponible durante la fase de encuestas de seguimiento (1 de mayo de 2025). |
Ver cronogramas |