Seleccionar un escritor técnico

Fase actual:
Se anunciaron los resultados. Consulta el cronograma.

En esta página, se incluyen sugerencias para organizaciones de código abierto sobre cómo evaluar y seleccionar al escritor técnico adecuado para su propuesta de proyecto de la temporada de Documentos de Google.

Introducción

Las organizaciones de código abierto deben contratar a un escritor técnico para que trabaje en el proyecto propuesto. Las organizaciones deben buscar su propio redactor técnico. Los escritores técnicos que estén interesados en trabajar con organizaciones que participan en la Temporada de documentos de Google pueden encontrar información en el repositorio de GitHub de la Temporada de documentos de Google y en el canal#season-of-docs de Write the Docs en Slack.

Comienza el proceso

Te recomendamos que comiences el proceso de búsqueda de un escritor técnico en cuanto creas que te gustaría participar en la Temporada de Documentos de Google.

Cómo evaluar a un escritor técnico

Te recomendamos que solicites ejemplos de documentación desarrollada anteriormente a los escritores técnicos que estás considerando para que puedas enfocarte en evaluar sus habilidades y experiencia en la escritura técnica.

Habilidades y experiencia en redacción técnica

  • Examina la experiencia previa del escritor técnico. Idealmente, el escritor técnico debería tener algo de experiencia previa en la escritura de documentación técnica para la industria del software. Uno de los objetivos de la Temporada de documentos de Google es brindarles a los redactores técnicos la oportunidad de participar en productos enfocados en los desarrolladores. Por esa razón, no es esencial que el escritor tenga experiencia con APIs, SDKs o con otras plataformas para desarrolladores, incluso si tu proyecto se enfoca en un público de desarrolladores.

  • Enfócate en las habilidades lingüísticas y de comunicación. Evalúa el trabajo anterior del escritor técnico desde este punto de vista. Lo más importante: ¿Puedes entender lo que escribió la persona? Si quieres hacer una revisión detallada del lenguaje del trabajo del escritor técnico, busca coherencia en la puntuación y la fraseología, una ortografía correcta y un lenguaje claro. ¿La frase es simple o complicada? ¿Las oraciones son cortas o se extienden hasta que se vuelven difíciles de seguir?

  • Presta atención al diseño del documento. Verifica el diseño general de los documentos de muestra. ¿Es lógico el diseño? ¿Puedes navegar fácilmente por el documento o el conjunto de documentación? ¿Hay duplicación de contenido o hay brechas evidentes?

Contratar a un redactor técnico

Las organizaciones deben contratar a un escritor técnico y completar el formulario de prueba de contratación de escritor técnico que se encuentra vinculado a continuación antes del 10 de mayo de 2023 a las 6:00 p.m. UTC.

Se completó la fase de contratación de escritores técnicos.

Asegúrate de hablar sobre la compensación y un programa de pagos con el escritor técnico antes de contratarlo. Recomendamos que las organizaciones creen un programa de pagos con redactores técnicos en función de los eventos importantes del proyecto, incluido un pago al inicio del proyecto. Ten en cuenta las fechas de pago, que solo ocurrirán dos veces a lo largo del programa, y los importes cuando crees un programa de pagos.

Nota: Las organizaciones que no hayan contratado a un escritor técnico y no hayan enviado el formulario de prueba de contratación de escritor técnico antes del 10 de mayo de 2023 a las 6:00 p.m. (UTC) no recibirán fondos en la primera fecha de desembolso.