Resumen de la reunión de documentación

Notas de la reunión del equipo de documentación celebrada el día 2024-24-09

Datos de la reunión

Próxima reunión semanal


Revisión del Spain Handbook de España

Comienza la reunión del Spain handbook @JavierCasares que Proporciona una detallada explicación de los objetivos que persigue su creación. Enfatizando que este proyecto es un Handbook de España para la comunidad de WordPress de España.

Es importante también su aportación al recordarnos que la estructura general del Spain Handbook es realizar una réplica flexible de la estructura de un Handbook de la comunidad global de WordPress.

@nilovelez hace un matiz importante al incidir en que el proyecto del Spain Handbook es un proyecto piloto, en el cual se realizan muchas tareas de forma manual, rozando lo artesanal y, por tanto, en constante evolución en cualquiera de sus aspectos.

Tras el debate generado en torno al proyecto: Propuestas para eventos de WordPress inclusivos, se ha acordado añadir esta documentación al Spain Handbook, previa revisión de @_dorsvenabili y @unintended8, en el apartado de eventos, dentro de la documentación del equipo de comunidad.

Asimismo, el grupo de contribución de diversidad deberá crear su propia estructura dentro de su espacio. Estas acciones deben ir acompañadas por la propuesta de @ dorsvenabili de publicar un post una vez esté todo revisado con el fin de ofrecer un mayor impulso y alcance al proyecto para realizar eventos WordPress inclusivos.

¿Por qué estas rutas dentro del Spain Handbook?

Esta pregunta se la han estado haciendo algunos de los creadores de contenido, pero también puede surgir en adelante con nuevos contribuidores de documentación.

Tras el debate previo en la anterior reunión, como en esta misma, se ha llegado a varias conclusiones que, si bien, no están grabadas a sangre y fuego, son las que finalmente tienen más sentido.

Con el fin de facilitar que cualquier miembro de la comunidad de WordPress de España pueda tener una guía rápida de todos los documentos que pueda necesitar para la creación de dicho evento.

Este debate se ha abierto con este proyecto, pero aplica a cualquier equipo que genere documentación para creación de eventos WordPress en España. Por ello, desde el equipo de documentación estamos muy agradecidos de haber podido tener esta nueva perspectiva y poder aplicarla en futuros nuevos documentos o proyectos creados.

Por tanto. Si un documento de cualquier equipo aplica a la creación de un evento WordPress, se creará una ruta que dirija directamente a comunidad/eventos.

Se vuelve a hacer énfasis que la base para realizar las contribuciones a nivel de documentación será el formato Markdown, dentro del propio Spain Handbook.

Los nuevos generadores de contenido tienen a su disposición un manual, especialmente creado para todo aquel que no tiene conocimientos de la herramienta.

Cualquiera puede acceder al manual de GitHub desde el propio Spain Handbook.

Un tema importante que se nos olvidó mencionar, pero que la dejo aquí, anotado, es que cualquiera que desee crear o aportar algo de documentación ha de hacerlo creando una copia del repositorio en su PC. De esta forma se realizan cambios, propuestas y demás acciones sobre la documentación sin que el Spain Handbook sufra ninguna alteración directa.

Siguiendo con el resumen, ha quedado bastante estructurada las dos partes de la documentación. Una es la organización interna que se puede realizar con la dependencia que existe entre diferentes equipos y la segunda es la imagen que ofrecemos al separar dichos grupos de forma individual, facilitando siempre al usuario final o a los demás contribuidores una estructura más cercana de qué grupos existen y como contactar o participar en dichos grupos.

Conclusión

Esta reunión nos sirve de aprendizaje y evolución de como debemos actuar los miembros de documentación a la hora de gestionar las nuevas propuestas o como presentarnos de forma más efectiva y amigable ante nuevos contribuidores.

props a @estelaris y a @glycymeris, por la revisión de este resumen.

#github, #handbook, #reunion, #wordcamp-espana