Propuesta: Uso del Handbook y sincronización automática
En los últimos años, la Comunidad de España ha estado creando contenido de forma repartida por varias partes de la web. El lugar de comunicación central ha sido el Equipo y como páginas de contenido, el Colabora.
Pero existe la posibilidad de que toda la parte de material como las Guías de la Comunidad, información de los distintos equipos y demás se gestionen desde el Handbook, que sería el lugar correcto para ello.
A nivel global, en los últimos tiempos se han implementado sistemas que permiten que la actualización de los Handbook se haga de manera automática, de forma que toda la Comunidad tiene la oportunidad de participar sin necesidad de tener acceso al sitio donde se publica la información. Esta gestión se hace desde GitHub y la publicación de los contenidos se hace mediante Markdown.
Este sistema permitiría que todos los equipos de la Comunidad de España puedan publicar sus manuales, tutoriales y otros contenidos, de forma que el control lo tenga la Comunidad y sea independiente de quien venga o vaya.
Un ejemplo de URL que podrían generarse es la siguiente (eliminado el HTTPS para no generar enlaces reales)
//es.wordpress.org/team/handbook/hosting/
//es.wordpress.org/team/handbook/hosting/entorno/
//es.wordpress.org/team/handbook/marketing/
//es.wordpress.org/team/handbook/marketing/comunicacion/
//es.wordpress.org/team/handbook/marketing/comunicacion/meetup/
//es.wordpress.org/team/handbook/marketing/comunicacion/wordcamp/
//es.wordpress.org/ team/handbook/plugins/
Con esta estructura, todos los equipos de Comunidad (registrados en el make.wordpress.org) tendrían «su carpeta» desde la que colgarían sus contenidos.
Ventajas e inconvenientes
Las ventajas son bastante claras. La primera es que cualquier persona puede colaborar en cualquiera de los elementos. Además, como queda registrado todo en GitHub, el trabajo que cada uno hace se verá reflejado en su perfil de Actividad si tiene sincronizado su Perfil con el de GitHub.
Otra gran ventaja es que la actualización es automática. Lo que se vaya aprobando, cada 15 minutos se irá sincronizando con el Handbook, de forma que no hace falta que nadie tenga un control excesivo de permisos sobre el sitio. Ahora mismo solo hay un elemento, que es la ordenación de los menús, que se debería gestionar manualmente.
Otra gran ventaja es que ese Repo desde el que se controla todo debe estar bajo la organización WordPress, lo que significa que se trabaja con herramientas, permisos y controles estándar de la Comunidad, y si alguien cambia o ha de dejarlo, siempre hay otras personas responsables de que ese material siga funcionando.
Entre los inconvenientes tenemos que hay que usar GitHub y Markdown. Aunque hoy en día son sistemas estándar, y son los que la Comunidad usa para otros proyectos, siempre puede ser un pequeño impedimento para otros. La solución es documentar muy bien el paso a paso y el uso de las herramientas. El equipo global de Documentación ya tiene este trabajo hecho en inglés.
¿Qué es necesario para llegar a esto?
Lo primero es plantear un repositorio existente o nuevo en el que todos los equipos trabajen conjuntamente. Solo puede haber un único repositorio para todo, ya que solo hay un Handbook para el sitio de España.
Lo siguiente es crear la estructura de carpetas base que se utilizará en el sitio. Por defecto debería ser el nombre de los distintos equipos WordPress tal y como se llaman en su versión en inglés, para simplificar sincronizaciones futuras (/hosting/, /plugins/, /docs/, /marketing/).
Una vez esté ese repo, se creará el software base (manifest) de sincronización y se pediría al equipo Global de meta que controle el repositorio, y que lo sincronice con la web.
A partir de ese momento, todos los cambios aprobados quedarán reflejados por la persona que los hace, se verán en su perfil, y se atribuirá la contribución correspondiente.
