Guía del administrador de la organización

Fase actual:
La temporada de Documentos de Google finalizó el 14 de diciembre de 2021. Consulta el cronograma.

Esta guía está dirigida a los administradores de organizaciones que se postulan al programa de la Temporada 2021 de Documentos o que participen en él.

¿Tu organización debe participar en el programa Temporada 2021 de Documentos?

Utiliza estas preguntas para comprender si tu organización o proyecto de código abierto debe participar en Season of Docs.

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 después de finalizada la temporada de documentos 2021.

La 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 2021 comienza el 9 de febrero de 2021, recomendamos 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? (Consulta la lista de ideas de proyectos para ver 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. 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.
  • 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 considerarán las propuestas incompletas.

  • Envía el formulario de solicitud antes de la fecha límite del 26 de marzo de 2021 a las 6:00 p.m. UTC. Las propuestas aceptadas se anunciarán el 16 de abril de 2021.

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 10 de junio de 2021, Season of Docs depositará el 40% de los fondos de subsidios 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 y casos de éxito finales, a partir del 14 de diciembre de 2021.
  • 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 un plazo de una semana después de recibir el vínculo al formulario de informe de estado (el vínculo se enviará por correo electrónico, así que revise su carpeta de spam).

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 30 de noviembre de 2021 a las 6:00 p.m. UTC para recibir los fondos restantes de la subvención.

Evaluación final

El formulario de evaluación final estará disponible para los administradores de la organización un mes antes del 30 de noviembre de 2021 a las 6:00 p.m. UTC.

Caso de éxito

El caso de éxito de Season of Docs es el entregable clave de la participación de tu organización en Season of Docs 2021. Llevar un registro semanal de las actualizaciones del proyecto te ayudará a crear tu caso práctico. 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 para crear tu caso de éxito. Deberás enviar tu caso práctico como vínculo en el formulario de evaluación final.

Tu caso práctico se publicará en el sitio Temporada de Documentos, así que tenlo en cuenta cuando incluyas información sobre tu proyecto.

Exigimos que las organizaciones participen en al menos tres encuestas de seguimiento para ayudarnos a hacer un seguimiento del éxito de los proyectos de Season of Docs a lo largo del tiempo.

Formularios

Formulario 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.

26 de marzo de 2021, 6:00 p.m. UTC
Información de pago de la organización

Se completó la fase de información de pago de la organización. Si necesitas hacer cambios en la información de pago de tu organización, comunícate con los administradores de la Temporada de Documentos.

12 de mayo de 2021, 6:00 p.m. UTC
Prueba de la contratación de escritor técnico

Se completó la fase de contratación del escritor técnico.

17 de mayo de 2021, 6:00 p.m. UTC
Evaluaciones mensuales

Evaluaciones mensuales

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).

30 de noviembre de 2021, 6:00 p.m. UTC
Encuestas de seguimiento

Formulario disponible durante la fase de encuestas de seguimiento (1 de mayo de 2025).

Ver cronogramas