WordPress / spain-handbook

Manuales de la Comunidad de WordPress España (Handbook)
https://es.wordpress.org/team/handbook/
GNU General Public License v3.0
21 stars 41 forks source link
documentacion manuales wordpress

Handbook Comunidad WordPress España

Esta organización de carpetas es la que cuelga de la ruta https://es.wordpress.org/team/handbook/.

IMPORTANTE: No todo lo que hay en este repositorio se publica automaticamente en el sitio web. Solo aquellas páginas definidas en el manifiesto aparecerán y se sincronizarán de forma automática.


Objetivo del Handbook

El Spain Handbook es el manual específico para la Comunidad de WordPress España. Son manuales horizontales y verticales específicos para elementos propios de la comunidad local.

Cómo se organiza

El Handbook se organiza en 3 partes:

  1. Información general y manuales genéricos (como los de GitHub o Markdown).
  2. Manuales concretos para acciones concretas que pertenecen a la comunidad en general (y no a un equipo)
  3. Páginas de equipo, donde está el manetrial para los Contributor Day.

La decisión de donde van los contenidos la decidirá el equipo de Documentación y los Locale Managers, con una visión amplia y de futuro. Hay que tener en cuenta que no se pueden redirigir las URL de un sitio a otro, por lo que una vez se publica algo, se debería dejar ahí siempre. Es por esto que la decisión final queda en manos de los gestores del Handbook para que el sistema disponga de una buena salud.

Cómo y cuándo se publica

Los Handbook se pueden configurar de forma automática o manual. En general, los de inglés, se gestionan de forma automática pasando de GitHub a WordPress mediante una herramienta y su "manifest".

En el caso de otros idiomas que usan caracteres UTF y no ASCII, el procedimiento, por ahora en manual. Esto no quiere decir que no se ptenga que mantener el sistema igualmente, ya qu, en el caso de este handbook, está pedido que se automatice y, si las configuraciones no corresponden, cuando se haga el cambio, se romperá todo.

En la actualidad (octubre/noviembre de 2024) se está trabajando en una herramienta alternativa 8que se publicará) que permita migrar de forma automática entre GitHub y WordPress sin depender de los caracteres (UTF/ASCII) mediante la REST-API de WordPress (pronto más información).