Cómo resolver el proceso de solicitud de Google Season of Docs para 2020

A lo largo de los años, las encuestas han demostrado la importancia de una buena documentación sobre cómo los desarrolladores eligen y utilizan el código abierto.

En el programa inaugural de Google Season of Docs (GSoD) en 2019, el programa recibió casi 450 solicitudes de redactores técnicos y se aceptaron más de 50 redactores técnicos.

Como uno de los escritores técnicos que fueron aceptados para participar en el programa Google Season of Docs, pensé en compartir algunas ideas sobre cómo preparar y crear una aplicación sólida para el programa GSoD.

Tabla de contenido

  • ¿Qué es Google Season of Docs?
  • ¿Quién es elegible para participar en el programa?
  • Beneficios de participar
  • 5 consejos para mejorar su aplicación GSoD
  • Mi experiencia GSoD
  • Recursos útiles

¿Qué es Google Season of Docs?

Season of Docs es un programa anual organizado por Google. Su objetivo es reunir a escritores técnicos y organizaciones de código abierto para fomentar la colaboración y la mejora de la documentación en el espacio de código abierto.

Esta iniciativa es extremadamente importante porque la documentación de un proyecto de código abierto proporciona una vía para que los usuarios no solo comprendan el proyecto, sino que también hagan contribuciones al mismo.

Durante el programa, los escritores técnicos aceptados pasan entre 3 y 5 meses creando un nuevo conjunto de documentos, mejorando la estructura de los documentos existentes, desarrollando un tutorial muy necesario o mejorando los procesos de contribución y las guías de una organización de código abierto.

¿Quién es elegible para participar en el programa?

De acuerdo con las reglas de Google, debe tener al menos 18 años al momento de registrarse. También debe tener experiencia previa como redactor técnico y ser elegible para trabajar en su país de residencia.

Si cumple con estos requisitos, puede solicitar participar en el programa Google Season of Docs.

Beneficios de participar

La participación en el programa Season of Docs conlleva muchos beneficios. Algunos son:

Puedes conseguir un estipendio

Una vez que haya completado el programa Google Season of Docs, Google le pagará un estipendio. Es importante tener en cuenta que este estipendio es opcional por lo que debes indicar que quieres que te paguen durante la fase de solicitud.

El monto del estipendio se calcula en función de su ubicación. Consulte aquí los detalles completos sobre los estipendios.

Mejoras tus habilidades

Otro beneficio obvio de participar en el programa Google Season of Docs es que le permite mejorar sus habilidades como escritor técnico.

Amplias tu red

Además de mejorar como escritor técnico, también tiene la oportunidad de trabajar con personas que hacen cosas increíbles en el espacio de código abierto.

En mi caso, tuve la oportunidad de trabajar con la organización VideoLAN y eso significó que tuve que trabajar en estrecha colaboración con el presidente de la organización y los principales contribuyentes a los proyectos.

Puede obtener recomendaciones y referencias

Al postularse para cualquier trabajo, tener una buena carta de recomendación a menudo ayuda a fortalecer su solicitud.

Trabajar en estrecha colaboración con un mentor en el proyecto Season of Docs presenta una oportunidad para asegurar una rica fuente de recomendaciones y referencias.

Obtienes acceso a oportunidades futuras

Si está listo para postularse para un puesto de redactor técnico en Google, incluir su experiencia en Season of Docs en su currículum le brinda más ventajas en comparación con otros solicitantes.

Te conviertes en colaborador de código abierto

Aparte de todos los beneficios antes mencionados, participar en la temporada del programa Docs significa que puedes contribuir a proyectos de código abierto. Esto ayuda al mundo a desacreditar el estereotipo de que las contribuciones de código abierto solo están destinadas a desarrolladores de software.

5 consejos para mejorar su aplicación GSoD

Aquí hay 5 consejos que le ayudarán a preparar y crear una aplicación sólida para el programa Season of Docs.

Crea y publica artículos en tu blog

Uno de los criterios más importantes para ser aceptado como escritor técnico en el programa Google Season of Docs es la capacidad de demostrar que tiene experiencia previa en escritura.

Google y los mentores propuestos para el proyecto en el que desea trabajar deben estar convencidos de que usted es la persona adecuada para trabajar en el proyecto. Esto significa que quieren ver una buena cantidad de documentación y artículos bien redactados que haya creado.

Afortunadamente, no es demasiado tarde para crear un blog o publicar más contenido en su blog ya existente.

Si ya tiene un blog, es una buena idea publicar más artículos bien escritos antes, durante y después de haber enviado su propuesta. Si no tiene ningún blog, todavía no es demasiado tarde para crear uno utilizando el Devblog de Hashnode o su plataforma preferida y publicar artículos bien escritos también.

Elija el proyecto de código abierto adecuado

Honestamente, no puedo exagerar la importancia de elegir el proyecto de código abierto correcto. Esto se debe a que tiene un papel importante que desempeñar para lograr que ingrese al programa.

Aquí están mis pensamientos sobre cómo elegir el proyecto correcto:

  • Revisa todos los proyectos aprobados e intenta seleccionar al menos 5 proyectos que te interesen.
  • Después de seleccionar al menos 5 proyectos, escanee nuevamente y reduzca los proyectos a un máximo de 3 proyectos y un mínimo de 2 proyectos.
  • Si bien puede ser razonable concentrarse en un proyecto durante la fase de solicitud, le animo a que solicite al menos dos proyectos para mejorar sus posibilidades de ser aceptado en al menos un proyecto.
  • Para cada proyecto que elijas, únete al canal de comunicación de las organizaciones e informa a los mantenedores del proyecto sobre tu interés en ese proyecto. De esa manera, podrá establecer una relación entre usted y el mentor. Además, tenga en cuenta que los mentores no eligen a las personas solo porque tienen las habilidades necesarias. También seleccionan a los solicitantes porque creen que también pueden trabajar con ellos. Entonces, cuando envíe un mensaje a un mentor, sea explícito acerca de exactamente lo que necesita y, lo más importante, no se enoje porque no respondieron de inmediato porque la mayoría de los mentores son voluntarios que tienen otros trabajos de tiempo completo.
  • No espere a que le den de comer con cuchara. Investiga mucho sobre el proyecto. Descubra y comprenda todo lo que necesita saber y si tiene alguna inquietud, comuníquese con el mentor propuesto de ese proyecto para obtener ayuda o pregunte a otros miembros de esa comunidad.
  • Lo más importante es que escriba todo lo que descubra durante su investigación que sea útil si lo aceptan para trabajar en el proyecto o información que ayudará a mejorar su propuesta.

Escribe una propuesta

Mucha gente no lo sabe, pero escribir una propuesta es vital. Le brinda una comprensión clara del objetivo del proyecto, el cronograma que le llevará completar el proyecto, lo que necesita saber, etc.

Aparte de eso, escribir una propuesta también le muestra a su mentor sus objetivos para el proyecto, por qué cree que es la persona adecuada para el puesto, su experiencia, los plazos del proyecto y más.

Después de escribir su propuesta, envíela al mentor del proyecto para su revisión. Su revisión le ayudará a conocer los requisitos del proyecto desde el punto de vista del mentor. Agregué un enlace a mi propuesta de Google Season of Docs en la sección Recursos.

Realizar al menos una contribución a la organización de código abierto

El programa Season of Docs no es como Google Summer of Code, donde se le solicita que realice al menos una contribución al proyecto de código abierto que le interese. Pero hacer una contribución definitivamente puede mejorar sus posibilidades de ser aceptado, así que trate de hacerlo.

Manténgase activo en la comunidad después de la fecha límite de solicitud

Después de enviar su solicitud, intente permanecer activo en esa organización de código abierto. Esto muestra a los mentores que te apasiona ese proyecto y la comunidad de código abierto en general.

Mi experiencia GSoD

Durante el programa GSoD el año pasado, tuve la oportunidad de trabajar con la organización VideoLAN en el proyecto Modernizar (reescribir) la documentación de usuario de VLC.

Después de que mi propuesta fue aceptada por la organización VideoLAN, mis mentores y yo acordamos los objetivos que se esperaba que alcanzara durante el programa Google Season of Docs.

Estos fueron mis objetivos:

  1. Reestructurar la documentación.
  2. Actualice la documentación para que se ajuste a las versiones modernas de VLC.
  3. Migre la documentación del usuario a Gitlab usando Sphinx y ReadtheDocs.
  4. Elimina imágenes e información obsoletas.
  5. Vuelva a escribir la documentación del usuario para que sea fácil de entender.
  6. Configúrelo para la traducción utilizando Sphinx Internationalization.

Aprendí mucho más sobre la organización VideoLAN y VLC, descubrí que VLC tiene más características que nunca conocí, y aprendí cómo usar la plataforma de documentación Sphinx y reestructurar el texto.

Mis habilidades de redacción técnica también mejoraron enormemente. En general, participar en el programa Google Season of Docs fue una de las mejores cosas que me sucedieron en 2019.

Recursos útiles

A continuación, encontrará una lista de recursos útiles que lo ayudarán a obtener más información sobre el programa Season of Docs y la redacción técnica.

  • Mi propuesta de temporada de documentos aceptada
  • Informe del proyecto de Google Season of Docs
  • Contribuciones de código abierto: un catalizador para el crecimiento
  • Guía del escritor técnico
  • Temporada de canal de Docs Slack
  • Escritura técnica impresionante

¿Te gusta este artículo? Siga a @Didicodes en Twitter.