Atraer y retener voluntarios para editar documentos técnicos para proyectos de código abierto

Soy editor voluntario de Mozilla Developer Network (MDN), una organización que crea software gratuito de código abierto como el navegador Firefox. MDN tiene una gran cantidad de temas técnicos pendientes de revisión , alrededor de 625 en este momento.

La mayoría de los temas son muy breves y están bien escritos, por lo que requieren pocas o ninguna edición. Otros temas son extensos y están escritos por personas inteligentes que no son muy buenas en redacción técnica. Muy pocos temas están mal escritos. El alcance, el ritmo y la elección de los temas a editar dependen del editor. Las pautas de estilo no son estrictas. Hasta ahora, no he encontrado ningún ejemplo interactivo que deba probarse.

Disfruto editando y encuentro gratificante contribuir al software de código abierto. También mejora mis habilidades de escritura/edición y adquiero conocimientos técnicos. Sin embargo, no hay muchas recompensas extrínsecas, como ganar puntos de reputación.

Las personas que hacen esto como voluntarias tienen que estar mayormente contentas con trabajar en silencio en segundo plano. ¿Tiene alguna sugerencia sobre cómo atraer y retener editores técnicos con ideas afines?

¡Publicar aquí es un buen comienzo!
El editor principal de MDN proporcionó la siguiente información adicional: Una forma rápida de familiarizarse con MDN es hacer revisiones editoriales. Muchos de nuestros colaboradores no son hablantes nativos de inglés, por lo que su contenido a menudo necesita una buena edición. Hacer algunas revisiones editoriales lo ayudará a familiarizarse con el entorno de edición y con parte del contenido en MDN. Aquí hay instrucciones sobre cómo hacerlo: developer.mozilla.org/en-US/docs/MDN/Contribute/Howto/…
Para crear contenido nuevo, necesitamos ayuda con el "Área de aprendizaje", que tiene tutoriales para personas que están aprendiendo desarrollo web sin experiencia previa en programación. Necesitamos tutoriales escritos, y especialmente ejercicios o actividades de "aprendizaje activo" para que los alumnos los prueben por sí mismos, para familiarizarse con conceptos específicos. Aquí hay una descripción general de las formas de contribuir al Área de aprendizaje: developer.mozilla.org/en-US/Learn/How_to_contribute
¿Podría decir un poco más sobre lo que implica la tarea de edición? ¿Están los revisores/editores principalmente limpiando el mal inglés, o están reestructurando secciones de la documentación, haciendo cumplir las pautas de estilo, probando ejemplos para ver si funcionan, ampliando la documentación concisa o incompleta, etc.? Las habilidades, los niveles de compromiso y las recompensas son diferentes según la tarea. ¡Gracias!
@Monica Cellio Depende de usted, el editor. Debido a la acumulación, edito la ortografía y la gramática básicas. Cuando encuentro un tema que necesita una reescritura, realizo ediciones básicas y lo dejo marcado para recibir más ediciones. La mayoría de los temas son muy breves y están bien escritos, por lo que requieren pocas o ninguna edición. Otros temas son extensos y están escritos por personas inteligentes que no son muy buenas en redacción técnica. Muy pocos temas están mal escritos. El alcance, el ritmo y la elección de temas para editar dependen de usted. Las pautas de estilo no son estrictas. Hasta ahora, no he encontrado ningún ejemplo interactivo que deba probarse.
Paso la mayor parte de mi tiempo en mi computadora portátil en Firefox y Thunderbird, por lo que aprecio a Mozilla, pero esta pregunta parece más un llamado para los voluntarios que una pregunta sobre cómo escribir. Una buena documentación es realmente mucho trabajo para producir y casi nunca genera ninguna gloria. Hago algo para un proyecto en el que trabajo porque creo en él (¡y casi nadie más está dispuesto!)
Gracias, @Joe. Mi pregunta es sincera. En particular la parte de retenerlos. Estoy perplejo. Estoy buscando alguna manera de apoyar y motivar a las personas que se ofrecen como voluntarias para proyectos como este.

Respuestas (2)

Escribo voluntariamente en sitios como este. Pero también escribo por dinero. (Mi trabajo de tiempo completo es maestro de escuela). Lo que me motiva a escribir en diferentes circunstancias varía. Por ejemplo, cuando escribo recursos didácticos no suelo aceptar un trabajo por menos de treinta libras la hora. Sin embargo, escribir aquí no paga. Lo hago porque me satisface ayudar a las personas y porque escribir sobre temas hace que mi pensamiento sobre ellos sea más claro. Una cosa que me ayuda a apreciar cómo ayudo a otras personas es el sistema de votación en el sitio. Si a la gente le gustan mis respuestas, las votan. Si no les gustan, los rechazan. Hay una respuesta tangible a lo que aporto.

Solo le pregunté a mi hijo, quien contribuyó con una gran cantidad de material a un sitio de Pokémon, por qué lo hizo. Él dijo: 'Porque pensé que estaba ayudando a la gente'. Recibió un premio, una copia de un nuevo juego, por sus contribuciones, pero no lo hizo por la recompensa. Lo hizo porque pensó que "podría aportar algo que valiera la pena".

Lo que veo que pide Mozilla es dinero o mi tiempo para leer sobre nuevas funciones, etc. No veo solicitudes de escritores. No veo beneficios para los escritores. Soy el tipo de persona que está preparada para hacer este tipo de trabajo y, sin embargo, no sabía que había una necesidad. Tienes que hacer esto más visible.

Soy multitarea en mi trabajo actual donde uno de mis deberes es escribir documentos técnicos. Estuve en un equipo durante los últimos 10 meses cuyo trabajo consistía en crear manuales de usuario, piezas de repuesto y de inicio rápido para 2 de las principales líneas de productos. La semana pasada comencé a crear los flujos de trabajo de servicio y los artículos de procedimientos en equipo con un técnico de campo senior. Este técnico superior está muy entusiasmado con el proyecto de documentación y está dispuesto a aportar su experiencia, pero no pone la mano en el teclado para escribir nada. No quiero perder esta oportunidad, así que no me quejo y también hago la parte de escribir, revisar, editar, etc.

Como trabajo adicional, actúo como el scrummaster del departamento de I + D y trato de convencerlos de que escriban todo, de todos modos, quieren expresarse prometiéndoles que voy a hacer la parte de revisión y edición. El proyecto de documentación de I+D no tiene ninguna presión ni respaldo por parte de la dirección, por lo que tengo problemas para convencer al equipo de I+D de que escriba sus procedimientos. Ninguno de ellos está dispuesto a participar.

Mi caso no es exactamente el que estás tratando, pero mi experiencia me dice que escribir no es para todos y que la mayoría de las personas confían en su memoria para hacer su trabajo. Solo tuve éxito en convencer a las personas para que contribuyeran con la documentación en los casos en que la parte contribuyente realmente necesitaba este contenido y tenía a alguien dispuesto a hacer la parte de escritura del trabajo.

Así que supongo que en su caso, debe averiguar las necesidades prácticas de documentación, estar disponible para los contribuyentes de contenido, anunciarlo y, lamentablemente, escribir algo de forma voluntaria y compartirlo con la comunidad. Mi conjetura es que si insistes en hacerlo durante algún tiempo, comenzarás a formar un pequeño grupo de escritores con ideas afines (con suerte).