Documentando WordPress en español, gracias al Handbook

¿Sabes que los equipos de la Comunidad de España tienen su documentación?
Si quieres contribuir en los equipos de España, existe documentación para ti, aunque ¿cómo y dónde se crea esa documentación específica? Vamos a darle un poco de contexto.

Pongámonos en situación: historia del Handbook y GitHub

Este proyecto tiene su nacimiento en enero del año 2019, que mediante el ticket #4572, se solicita la activación del complemento HelpHub para el sitio web de España.

La obtención de la activación del complemento y el inicio del proyecto tuvieron lugar durante la WordCamp Málaga 2020.

Posteriormente, con la creación del ticket #6714, Javier Casares solicitó el acceso al repositorio, lo que permitió la migración y organización del trabajo realizado hasta ese momento.

En una fase posterior del proyecto, durante una revisión de tickets en el Community Summit y la WordCamp US de septiembre del 2023, se crea el ticket #7347.

En esta ocasión, Javier Casares señaló que las tablas de la base de datos estaban configuradas en «latin1», siendo necesario ajustarlas a «utf8» para que el sincronizador de contenidos entre GitHub y WordPress.org pudiera funcionar y continuar con el proyecto piloto iniciado

Cómo contribuir en WordPress con GitHub

Para comenzar a colaborar en el HandBook de WordPress España, sigue estos tres sencillos pasos:

• Crea un perfil de WordPress.org

Si ya dispones de un perfil, ¡genial! En caso contrario puedes crear uno.

• Crea una cuenta en GitHub

Si no dispones de una, puedes crearla en su página oficial.
Además, dispones de un documento explicando el paso a paso para facilitarte el proceso. En él, encontrarás instrucciones ampliadas sobre la activación de doble factor, la App de GitHub Mobile o la versión de escritorio, todas ellas muy útiles para utilizar GitHub.

• Vincular ambas cuentas

Este paso es importante. De esa forma, todas las contribuciones que realices en el Handbook de España se verán reflejadas en tu perfil de WordPres.org; sigue estas sencillas instrucciones y ya habrás terminado.

Estos tres sencillos pasos te aportan una base sólida para colaborar en el desarrollo del HandBook de WordPress de España.

Familiarízate con GitHub y contribuye

Gracias principalmente a Jesús Yesares disponemos todos los miembros de la comunidad de WordPress España de una serie de manuales para familiarizarnos con la herramienta de GitHub.

En ellos comprobarás varios aspectos característicos:

• GitHub siempre está en constante evolución.
• Dispone de su propio sistema de escritura Markdown.
• Código abierto en estado puro, todos tenemos acceso a todo.
• Incita a la participación y la integración.

En los manuales GitHub y Markdown ha participado también Erika Orlando, Javier Casares, y yo, aunque en menor medida por estar aprendiendo el funcionamiento de GitHub.

De hecho, yo soy la prueba de que estos manuales funcionan. Gracias a ellos he aprendido a utilizar GitHub y contribuir de forma activa en WordPress.org y en el HandBook de España.

Existen más, pero revisando y aplicando el manual de GitHub del Handbook con sus principales características y el manual de Markdown del Handbook, obtendrás, como lo hice yo, la base necesaria sin tener conocimientos previos.

Un proyecto activo, proactivo y de libre acceso

Actualmente, los miembros de la comunidad de WordPress España que trabaja o ha trabajado con el repositorio WordPress/Spain-Handbook para su organización, revisión y creación de contenidos lo formamos 16 personas.

Aunque hemos experimentado un aumento significativo en el número de colaboradores que se han sumado al proyecto, considero que sería beneficioso dar un poco más de visibilidad a este crecimiento. Esto podría incentivar a más colaboradores a unirse y contribuir al desarrollo del HandBook.

Por ello se preparó para la WordCamp de Zaragoza 2024 un pequeño ejercicio práctico que, una vez realizados los pasos previos de activación y vinculación de las cuentas de WordPress.org y GitHub, puedas poner a prueba tus conocimientos.

El primer ejercicio está diseñado para personas que no están familiarizadas con el funcionamiento de GitHub, y siempre se ha llevado a cabo con la asistencia de colaboradores que te guiarán en cada paso.

En Zaragoza, la responsable fue Erika Orlando, quien estuvo al frente de la actividad, proporcionando orientación y apoyo durante todo el proceso.

Esta iniciativa se complementa con otro ejercicio más avanzado, diseñado específicamente para brindar información y formación a cualquier persona que lo necesite. A continuación, te proporciono los enlaces correspondientes.

¿Tienes ya un equipo en el que colaborar?

La comunidad de WordPress España, sus equipos, los líderes de equipo y cualquiera que esté colaborando en mayor o menor medida tiene ante sí la posibilidad de crear material y documentación para alojarlo en el Handbook de España.

Ofreciendo la posibilidad de tener preparado material para los Contributor day. A modo de ejemplo de utilidad, el equipo de documentación preparó de forma previa al evento una serie de actividades para realizar con motivo de la WordCamp Zaragoza 2024.

Es sencillo de preparar y de aplicar. Es funcional e invita a colaborar más allá del propio Contributor day. Permitiendo que cualquiera pueda iniciar o continuar lo que comenzó dentro del Handbook en el momento que lo desee y en cualquier equipo de todos los que integran WordPress España.

Continuar documentando

Ahora, ya sabes cuál es la labor del equipo de documentación, mostrándote dónde y cómo se está gestionando, organizando y mejorando continuamente la documentación de WordPress España.

De esta manera, invitamos a todos a acceder, participar y proponer cambios, con el objetivo de contribuir al desarrollo de la comunidad de WordPress España y mantener su posición destacada dentro de la comunidad global de WordPress.