Fase actual:
Finalización del proyecto. Consulta el cronograma.
Estos son algunos lineamientos para ayudar a las organizaciones de código abierto a trabajar de manera eficaz con los redactores técnicos.
Presenta al escritor técnico al mundo del código abierto y a tu comunidad
- Dale al escritor técnico una “visita guiada” por tu comunidad. ¿Dónde pueden hacer preguntas? ¿A qué reuniones regulares debería asistir o a qué listas de distribución debería unirse? ¿Qué cuentas necesitan (GitHub, Discord, Slack)? Asegúrate de que comprendan el código de conducta de tu proyecto y sepan cómo informar cualquier problema. Asegúrate de que el redactor técnico comprenda la licencia de tu proyecto y cumpla con los requisitos de otros empleadores en relación con la firma de CLA, DCOs o cualquier otro acuerdo.
- Si es posible, preséntale a algunas personas que se encuentren en zonas horarias superpuestas y que puedan responder rápidamente las preguntas sobre la comunidad o el proyecto.
- Si puedes, envíale algunos artículos promocionales del proyecto.
Ayuda al escritor técnico a usar las herramientas y los procesos que se requieren para contribuir a tu proyecto
- Si tus procesos no están bien documentados, programa un momento para explicarle al escritor técnico su primera contribución, problema o solicitud de extracción. ¿Qué plantillas o etiquetas deberían usar? ¿Quién debe revisar su contribución y cómo y cuándo debe hacer un seguimiento de las revisiones? Si su trabajo incluye muestras de código, ¿cómo se pueden probar? ¿Qué necesitan saber sobre tu proceso o lanzamientos de CI/CD?
Ayuda al escritor técnico a comprender tu proyecto y sus usuarios
- Explica tu proyecto en detalle para que el redactor técnico obtenga una comprensión conceptual firme del producto. Esto puede ayudar al escritor técnico a sentirse más seguro y tener más autoridad en su redacción para el proyecto.
- Describe las necesidades de las personas que usan el proyecto. Sé lo más específico posible, no solo "desarrolladores", sino "desarrolladores que crean sitios web" y "desarrolladores que programan robots industriales".
- Poner al escritor técnico en contacto con los expertos en la materia necesarios Es decir, los desarrolladores o cualquier otra persona que haya contribuido con el proyecto y que sea responsable de los aspectos que se abordarán en la documentación.
- Asegúrate de que el redactor técnico obtenga el tiempo y los recursos que necesita de los expertos en el tema y de cualquier otro miembro de la comunidad.
Haz preguntas.
- Es posible que tu comunidad o proyecto no haya trabajado con escritores técnicos ni colaboradores de documentación antes. Aprovecha la oportunidad de aprender mientras compartes lo que sabes. Pide comentarios sobre tus procesos y herramientas. Es probable que el escritor técnico tenga algunas sugerencias para mejorar.