Fase actual:
El programa de la Temporada de documentos de 2021 finalizó el 14 de diciembre de 2021. Consulta el cronograma.
Esta página está destinada a organizaciones de código abierto que se encuentran en la fase de exploración del proceso de postulación de la organización. Estas ideas de proyectos son solo ejemplos para mostrar cómo las organizaciones podrían describir posibles proyectos de documentación en la página de ideas de proyectos de la organización. Las organizaciones pueden proponer proyectos que no se incluyen en esta lista.
Idea de proyecto: crea una guía de integración para colaboradores
Problema
- Los colaboradores nuevos no pueden encontrar la información de configuración que necesitan para realizar contribuciones significativas a nuestro proyecto. Algunos procesos (como contribuir a nuestras pruebas) no están documentados en absoluto.
¿Cómo mediríamos el éxito?
- Aumento en la cantidad de colaboradores nuevos
- Aumento en la cantidad de colaboradores nuevos que no escriben código (ya que facilita la colaboración en documentos o pruebas)
- Disminución en la cantidad de problemas que plantean los colaboradores nuevos
- de aumento en la cantidad de problemas cerrados etiquetados con “buen primer problema”
¿Qué habilidades necesitaría un escritor técnico para trabajar en este proyecto?
- Requisitos: Familiaridad con GitHub (o disposición para trabajar con los instructivos de GitHub)
- Es recomendable tenerla: Estar familiarizado con nuestro ejecutor de pruebas para ejecutar nuestras pruebas y actualizar la documentación para hacerlo
Voluntarios
Invita a los miembros de la comunidad a registrarse para ayudar con tareas específicas, por ejemplo:
- @JaneQDev, puede ayudarte a responder preguntas sobre nuestras pruebas
- @ChenPCoder, con gusto revisaré las solicitudes de extracción de Documentos
- @ErichJEngineer, puedes explicar el proceso de contribución actual con el escritor técnico
Información de contacto
- Los redactores técnicos interesados en trabajar en este proyecto deben enviar un correo electrónico a email@project. Incluye vínculos a tu trabajo de redacción técnica o a tu portafolio, currículum o CV.
Idea del proyecto: escribir instructivos para usar nuestra biblioteca con …
Problema
- Nuestro proyecto recibe muchos problemas que plantean los usuarios que intentan usar nuestra biblioteca con $TechnologyX. No tenemos una guía clara para la integración con $TechnologyX y puede ser complicado.
¿Cómo medimos el éxito?
- Disminución en la cantidad de problemas etiquetados como "$TechnologyX"
- Aumento en la cantidad de solicitudes de extracción de colaboradores nuevos que nos ayudan a corregir errores o a agregar documentación sobre $TechnologyX
- Más vínculos a nuestro proyecto desde los proyectos de $TechnologyX
¿Qué habilidades necesitaría un escritor técnico para trabajar en este proyecto?
- Deseable: Tener cierta familiaridad con $TechnologyX
Voluntarios
Invita a los miembros de la comunidad a registrarse para ayudar con tareas específicas, por ejemplo:
- @JaneQDev, puedo ayudarte a responder preguntas sobre $TechnologyX
- @ChenPCoder, con gusto revisaré las solicitudes de extracción de Documentos
Información de contacto
- Los redactores técnicos interesados en trabajar en este proyecto deben enviar un correo electrónico a email@project. Incluye vínculos a tu trabajo de redacción técnica o a tu portafolio, currículum o CV.
Idea del proyecto: Reorganizar nuestra documentación
Problema
- Nuestra documentación es amplia y desorganizada. Muchos usuarios dejan de intentar encontrar respuestas en la documentación y, en su lugar, plantean problemas o hacen preguntas en nuestros foros. Nuestras páginas no aparecen en los resultados de la búsqueda, ni siquiera para las palabras clave relevantes.
¿Cómo mediríamos el éxito?
- Mejor SEO para nuestra documentación
- Disminución en la cantidad de problemas planteados sobre temas que se abordan en la documentación
- Aumento en la cantidad de contribuciones a la documentación
¿Qué habilidades necesitaría un escritor técnico para trabajar en este proyecto?
- deseable: experiencia en la reorganización de conjuntos de documentación grandes y maduros, y comprensión de la SEO.
Voluntarios
Invita a los miembros de la comunidad a registrarse para ayudar con tareas específicas, por ejemplo:
- @ChenPCoder, quiero revisar las solicitudes de extracción de documentos
Información de contacto
- Los redactores técnicos interesados en trabajar en este proyecto deben enviar un correo electrónico a email@project. Incluye vínculos a tu trabajo de redacción técnica o a tu portafolio, currículum o CV.
Idea del proyecto: Ejecutar una corrección de documentación
Problema
- Tenemos muchos errores pequeños y problemas antiguos relacionados con nuestra documentación. Nuestra comunidad estaría feliz de poder colaborar y ayudar a mejorar la situación, pero necesitamos a alguien que organice y ejecute la solución.
¿Cómo mediríamos el éxito?
- Cantidad de problemas relacionados con la documentación cerrados
- Aumento en la cantidad de contribuciones de documentación y nuevos colaboradores
¿Qué habilidades necesitaría un escritor técnico para trabajar en este proyecto?
- Deseable: Experiencia en la ejecución de una solución de problemas de documentación
- Excelentes habilidades organizativas
Voluntarios
Invita a los miembros de la comunidad a registrarse para ayudar con tareas específicas, por ejemplo:
- @ChenPCoder, puede ayudar a organizar el video y el chat para la solución y a encontrar voluntarios en otras zonas horarias.
Información de contacto
- Los redactores técnicos interesados en trabajar en este proyecto deben enviar un correo electrónico a email@project, abrir un problema o hacer preguntas en nuestro foro. Incluye vínculos a tu trabajo de redacción técnica o a tu portafolio, currículum o CV.
Idea del proyecto: Realiza una auditoría de documentación
Problema
- No tenemos una buena idea del estado de nuestra documentación. Es difícil priorizar las mejoras en la documentación porque no tenemos una hoja de ruta ni una idea de cuáles son los problemas más urgentes. También tenemos mucho contenido desactualizado que se debe borrar o archivar.
¿Cómo mediríamos el éxito?
- Creación de una hoja de ruta de documentación con la aprobación general de la comunidad
- Disminución de la cantidad de páginas de documentación desactualizadas o incorrectas
¿Qué habilidades necesitaría un escritor técnico para trabajar en este proyecto?
- deseable: experiencia en auditorías de documentos,
Voluntarios
Invita a los miembros de la comunidad a registrarse para ayudar con tareas específicas, por ejemplo:
- @JaneQCoder, puede ayudar a coordinar la presentación de la hoja de ruta de documentación en nuestra reunión de la comunidad.
Información de contacto
- Los escritores técnicos interesados en trabajar en este proyecto deben enviar un correo electrónico a email@project/abrir un problema/preguntar en nuestro foro. Incluye vínculos a tu trabajo de redacción técnica o a tu portafolio, currículum o CV.
Información relacionada
- La página Promoción y prensa incluye logotipos y otro contenido que puedes usar cuando hables de la Temporada de Documentos de Google.
- En este video de PyCon Australia 2017, Daniele Procida brinda sugerencias para organizar tu documentación de modo que las personas la encuentren útil: What nobody tells you about documentation.