Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
javiercasares authored Oct 24, 2024
1 parent 5140eae commit 7dde193
Showing 1 changed file with 24 additions and 0 deletions.
24 changes: 24 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,3 +3,27 @@
Esta organización de carpetas es la que cuelga de la ruta [`https://es.wordpress.org/team/handbook/`](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)_.

0 comments on commit 7dde193

Please sign in to comment.