Resumen de la reunión de documentación

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

Datos de la reunión

Próxima reunión semanal

Revisión del proyecto de traducción y localización de la documentación de usuarios finales

@estelaris comienza haciendo un repaso de lo que se ha avanzado con la herramienta Glotpress, la cual permite ya la traducción por bloques de frases.
Se indicó que los artículos se agregaran en bloques en inglés a la herramienta y cada bloque equivale a un párrafo que se puede traducir de forma automática.

En principio se va a realizar la traducción de los rosetta y una vez que todo funciones de forma correcta se puede traducir la documentación para usuario final mediante este sistema.

Se explican las novedades que pueden venir próximamente como es una documentación al estilo «Wikipedia», este sistema permitiría en un futuro que la actualización de la documentación fuese más sencilla de realizar.

Otra novedad que ha anunciado @estelaris es la automatización de las actualizaciones a nivel global de los rosetta, aunque es algo que aún está por definir el sistema que se va a utilizar, es un cambio que se prevé que llegue próximamente.

@estelaris hablará con el equipo de Meta para que se nos asigne un entorno de desarrollo y poder realizar nuestro trabajo en él.


Revisión del Spain Handbook de España

@glycymeris Pone al día el estado del Spain handbook que, tras el parón veraniego, siguen pendientes algunas partes del manual de GitHub, el cual se va a terminar en el menor tiempo posible. Agradecimientos a @bertaminguela

@anagavilan en representación del equipo de comunidad viene a presentar el proyecto de una guía para conseguir eventos WordPress más inclusivos. Cuando hablamos de «eventos» incluye cualquier evento bajo la marca WordPress, aunque en esta ocasión se centra la conversación y el proyecto de guía en un evento WordCamp.

Podéis leer la propuesta haciendo clic aquí.

Tras debatir la ruta más coherente y con más sentido se ha llegado a la conclusión que esta guía se quede reflejada en la documentación referente a la creación u organización de un evento WordPress, en el caso del Spain Handbook quedará fijado en: comunidad/WordCamp y se realice un enlace al equipo de sostenibilidad para que, quien quiera, pueda tener un acceso directo a su contenido.

Esta decisión se toma porque quien en su momento esté en el equipo de organización de un evento, tenga toda la documentación en el lugar donde aparecen los eventos.

Dada la importancia que la comunidad de WordPress España otorga a poder crear eventos WordPress, inclusivos y sostenibles se ha decidido por parte del equipo de documentación que estos textos sean revisados y aprobados por miembros de la comunidad global, con la autoridad y conocimientos suficientes para que, cuando se publiquen sean perfectamente aplicables siguiendo los protocolos que dicta WordPress.org y el equipo de sostenibilidad.

@glycymeris y @josepmoran como revisores de la documentación que va añadiéndose al Spain Handbook se posicionan que dada la importancia de los textos, carecen de los conocimientos técnicos necesarios y que no revisarán la validez del contenido, simplemente lo aprobarán para que un GTE, pueda dar el visto bueno en lo que respecta a la correcta aplicación de la guía de estilos y el glosario.

Se ha acordado la inclusión de una sección al final de los textos generados en los que se haga mención explícita (props) o similar, conforme los textos han sido revisados por miembros de la comunidad global, con la autoridad suficiente, para evitar posibles incumplimientos de leyes o directrices en la creación de eventos WordPress.

Una vez aprobado por parte del GTE, los textos se publicarán de manera inmediata en el Spain Handbook siguiendo la ruta anteriormente mencionada, añadiendo un enlace en el equipo de diversidad.

@glycymeris y @josepmoran anuncian la creación de un Contributor Day, específico para documentación. Finalmente, con el fin de poder ensanchar la base de contribución en WordPress España se acuerda realizarlo a través de Zoom y se extiende a los equipos que quieran participar.

La fecha de este nuevo proyecto se indicará de forma formal en próximas reuniones.


Props a @estelaris y @glycymeris



#github, #handbook, #reunion