Guía para el mentor

Fase actual:
La temporada de Documentos del programa 2019 finalizó el 6 de marzo de 2020. Consulta el cronograma.

Esta es una guía para mentores de código abierto, es decir, miembros de organizaciones de código abierto que participan en Season of Documentos como mentores de escritores técnicos.

Introducción

La guía te ayuda a realizar las tareas de las que eres responsable en cada fase de la temporada de Documentos.

Uno de tus objetivos como mentor es garantizar que los escritores técnicos tengan una experiencia gratificante y exitosa en la temporada de Documentos de este año. Eso mejorará las posibilidades de que los escritores técnicos sigan contribuyendo a tu proyecto de código abierto después del cierre de la temporada de Documentos de este año y de que otros escritores técnicos se entusiasmen con el trabajo en código abierto.

Fase de solicitud de la organización

La fase de aplicación de la organización va del 2 al 23 de abril de 2019. Durante este período, el administrador de la organización puede enviar una solicitud para que esta participe en Season of Docs. Los administradores del programa de Google publican la lista de organizaciones exitosas el 30 de abril de 2019.

Tus tareas como mentor durante esta fase

Crea tu lista de ideas.

Trabaja con el administrador de tu organización a fin de crear una lista de ideas para proyectos. La lista debe incluir uno o más proyectos de documentación que te gustaría que un escritor técnico aborde durante la temporada de Documentos de este año.

Ideas para proyectos de escritura técnica

Regístrate en la temporada de Documentos.

Regístrate en la temporada de Documentos lo antes posible.

Ya cerró el período de registro para la temporada 2019 de Documentos.

Hable sobre la temporada de Documentos.

¡Cuéntale a tu organización que participará en esta temporada de Documentos! Incluso si tu organización no se encuentra en la lista final de organizaciones aceptadas este año, es una buena noticia que hayas formado parte del proceso de selección.

Material promocional

Fase de exploración del escritor técnico

La fase de exploración del escritor técnico va del 30 de abril al 28 de mayo de 2019. Durante este período, los escritores técnicos exploran la lista de organizaciones participantes y las ideas de proyectos de las organizaciones. Los escritores técnicos pueden comunicarse con una o más organizaciones directamente para analizar ideas de proyectos.

Tus tareas como mentor durante esta fase

Debatir ideas de proyectos con escritores técnicos interesados.

Puedes analizar las ideas de proyectos con cualquier escritor técnico que se comunique directamente con tu organización para ayudarlo a elaborar una buena propuesta de proyecto para enviarla a los administradores del programa de Google. Las ideas de proyecto pueden provenir de la lista de ideas que propuso tu organización, así como de otras ideas que proponga el escritor técnico.

Ideas para proyectos de escritura técnica

Evaluación de las propuestas técnicas del escritor

Fase de postulación del escritor técnico

La fase de solicitud del escritor técnico dura del 29 de mayo de 2019 al 28 de junio de 2019. Durante este período, los escritores técnicos se postulan para participar en Season of Docs, y las organizaciones seleccionan los proyectos para los que quieren ser mentores.

Tus tareas como mentor durante esta fase

Evaluar las propuestas técnicas del escritor

Trabaja con el administrador de la organización para evaluar las propuestas del escritor técnico y seleccionar los proyectos de escritura técnica que tu organización desea supervisar durante la temporada de Documentos de este año.

Evaluación de las propuestas técnicas del escritor

Fase de vinculación con la comunidad

La fase de vinculación con la comunidad se extiende del 7 de agosto al 1 de septiembre de 2019. Durante este período, los mentores ayudan a los escritores técnicos aceptados a familiarizarse con el proyecto de código abierto.

Tus tareas como mentor durante esta fase

Presenta al escritor técnico el proyecto de código abierto y la comunidad.

Presenta al escritor técnico la organización de código abierto y ayúdalo a familiarizarse con las herramientas y los procesos que usas.

Trabajar con un escritor técnico

Tus responsabilidades

Explica tu producto al escritor técnico.

Dedica tiempo a explicar el producto (en especial desde el punto de vista conceptual) y asegúrate de que el escritor técnico comprenda al público de la documentación.

Trabajar con un escritor técnico

Configura los canales de comunicación.

Alienta al escritor técnico a presentarse en las listas de distribución de la comunidad, el chat, el canal de Slack y cualquier otro canal de comunicación compartido. Asegúrate de que el escritor técnico pueda comunicarse directamente contigo de forma confiable.

Tus responsabilidades

Establece objetivos y expectativas.

Trabaja con el escritor técnico para definir mejor los objetivos de su proyecto de escritura técnica y establecer expectativas para ambas partes. El objetivo es garantizar el éxito del proyecto.

Tus responsabilidades

Fase de desarrollo del documento

La fase de desarrollo de documentos abarca del 2 de septiembre de 2019 al 22 de noviembre de 2019. Durante este período, los escritores técnicos trabajan en sus proyectos en estrecha colaboración con sus mentores.

Tus tareas como mentor durante esta fase

Aconseja y alienta al escritor técnico.

Trabaja en estrecha colaboración con el escritor técnico para garantizar la finalización exitosa del proyecto.

Trabajar con un escritor técnico

Tus responsabilidades

Completar las encuestas de los administradores del programa de Google

Los administradores del programa de Google pueden enviar una encuesta a mitad del proyecto para evaluar el progreso. Completa la encuesta y envía tus respuestas a los administradores del programa de Google según las instrucciones que figuran en el documento de la encuesta.

Fases de finalización y evaluación del proyecto

La fase de finalización del proyecto se extiende del 25 de noviembre al 6 de diciembre de 2019. (Las fechas son diferentes para los proyectos de larga duración). Durante este período, los escritores técnicos envían los productos finales de su trabajo y sus evaluaciones de mentores.

La fase de evaluación del mentor dura desde el 2 de diciembre de 2019 hasta el 6 de diciembre de 2019 a las 6:00 p.m. UTC. Durante este período, los mentores envían sus evaluaciones sobre el éxito de los proyectos de redacción técnica y su experiencia de trabajo con escritores técnicos.

Tus tareas como mentor durante esta fase

Escribe y envía tu evaluación del proyecto de redacción técnica.

Completa y envía tus evaluaciones antes del 28 de febrero de 2020 a las 6:00 p.m. UTC.

Evaluar un proyecto de escritura técnica

Finalizó la fase de finalización de proyectos de la temporada 2019 de Documentos.

Proyectos de larga duración

En el caso de los proyectos de escritura técnica de longitud estándar en Season of Docs, la fase de desarrollo de documentos abarca del 2 de septiembre de 2019 al 22 de noviembre de 2019. Sin embargo, algunos escritores técnicos pueden solicitar un proyecto de larga duración con asesoramiento de la organización de código abierto. En el caso de un proyecto de larga duración, la fase de desarrollo de documentos se extiende del 2 de septiembre de 2019 al 21 de febrero de 2020.

El período de finalización y evaluación para los proyectos de larga duración es del 24 al 28 de febrero de 2020. Durante este período, los escritores técnicos envían las evaluaciones y los productos finales de su trabajo, y los mentores envían las evaluaciones.

Tus tareas como mentora de un proyecto de larga duración

Aconsejar al escritor técnico y enviar la evaluación de tu proyecto.

Tus tareas y responsabilidades son las mismas que se describen en esta página para los proyectos de escritura técnica de longitud estándar, excepto que las fechas de finalización y evaluaciones de proyectos son posteriores.