Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Realizada la revisión de todo el manual hasta los cambios realizados por Alex y mejoras de estilo #40

Merged
merged 7 commits into from
Jan 29, 2022
Binary file removed 1.AltaGitHub.png
Binary file not shown.
39 changes: 26 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,46 +1,59 @@
# Handbook Comunidad WordPress España

## ¿Qué es WordPress España?
## <a name="top">Índice</a>

1. [¿Qué es WordPress España?](#paso-1)
2. [Objetivos del handbook](#paso-2)
3. [¿Cómo colaboramos?](#paso-3)
* 3.1. [Alojamiento y control de versiones de los manuales (handbooks)](#paso-3-1)
* 3.2. [Escritura de los textos del manual](#paso-3-2)
* 3.3. [Comunicación entre los miembros del equipo de marketing](#paso-3-3)

## <a name="paso-1">¿Qué es WordPress España?</a>

La comunidad de WordPress España es un grupo de personas que colaboran en el desarrollo de WordPress.org, organizamos la documentación estandar, a la que llamamos manuales o "HandBook".

La finalidad es unificar criterios a la hora de desarrollar los distintos proyectos/formas de organizar.

Este Manual recoje, a su vez, los diferentes manuales exitentes que ha generado la comunidad WordPress España a lo largo de los años. Lo tienes disponibles a continuación.
Tu también puedes colaborar [Sección Colabora] (https://es.wordpress.org/colabora)
Tu también puedes colaborar [Sección Colabora](https://es.wordpress.org/colabora)

## <a name="paso-2">Objetivos del handbook</a>

## Objetivos del handbook
Para organizar los manuales y guías, hemos creado este repositorio para la comunidad de WordPress España.

Manuales actuales:
- [Manual de Comunicación para WordCamps](manual-comunicacion-wordcamps/README.md)
- [Manual de GitHub](manual-github/README.md)

## <a name="paso-3">¿Cómo colaboramos?</a>

## ¿Cómo colaboramos?
### Alojamiento y control de versiones de los manuales (handbooks)
Colaboraremos a través de un repositorio en Github. Hemos propuesto este sistema porque es el mejor para llevar un control de las aportaciones y las diferentes versiones del documento. Este es el sistema mediante el cual millones de programadores en el mundo han construido cosas tan chulas como WordPress. ¿Por qué no aprender nosotros de ellos?
### <a name="paso-3-1">Alojamiento y control de versiones de los manuales (handbooks)</a>

A continuación te contamos cómo empezar en **Github**, desde darte de alta hasta finalizar tu colaboración.
Colaboraremos a través de un repositorio en GitHub. Hemos propuesto este sistema porque es el mejor para llevar un control de las aportaciones y las diferentes versiones del documento. Este es el sistema mediante el cual millones de programadores en el mundo han construido cosas tan chulas como WordPress. ¿Por qué no aprender nosotros de ellos?

A continuación te contamos cómo empezar en **GitHub**, desde darte de alta hasta finalizar tu colaboración.

- [Manual GitHub](manual-github/README.md)

### Escritura de los textos del manual
### <a name="paso-3-2">Escritura de los textos del manual</a>

El editor de texto que utiliza Github está basado en *Markdown*, un tipo de codificación muy sencilla que te permitirá dar formato al texto plano. Para aprender lo poco que necesitas conocer de Markdown, a la hora de escribir en github, te recomendamos que eches un vistazo a este [Manual de Markdown](https://commonmark.org/help/) y que hagas el tutorial de 10 minutos.
El editor de texto que utiliza GitHub está basado en *Markdown*, un tipo de codificación muy sencilla que te permitirá dar formato al texto plano. Para aprender lo poco que necesitas conocer de Markdown, a la hora de escribir en GitHub, te recomendamos que eches un vistazo a este [Manual de Markdown](https://commonmark.org/help/) y que hagas el tutorial de 10 minutos.

Como escribir tablas en Markdown es engorroso, puedes utilizar como apoyo este [generador de tablas en Markdown](https://www.tablesgenerator.com/markdown_tables).

Si tienes un conocimiento más avanzado de GIT, puedes editar tu fork del repositorio directamente en local con cualquier editor de código como Visual Studio Code, Atom, Sublime text, etc.

Si quieres más información sobre cómo colaborar en un proyecto con Github, puedes consultar [este manual](https://gist.github.com/BCasal/026e4c7f5c71418485c1).
Si quieres más información sobre cómo colaborar en un proyecto con GitHub, puedes consultar [este manual](https://gist.github.com/BCasal/026e4c7f5c71418485c1).

### Comunicación entre los miembros del equipo de Marketing
### <a name="paso-3-3">Comunicación entre los miembros del equipo de Marketing</a>

La herramienta habitual de comunicación entre miembros voluntarios es **Slack**. Si quieres saber cómo darte de alta en esta herramienta o cómo entrar en los grupos de colaboración de WordPress en Slack, sigue [este tutorial](https://es.wordpress.org/guias/chat/).

**Nota**: en los documentos hemos puesto genéricos los nombres del lugar como LLL, el año como YYY, DDD fechas. De manera que si haces búsqueda y reemplazar, podrás tener adaptado a tu WordCamp. Recuerda repasar el texto antes de publicarlo.

**Nota**: De forma provisional, durante la realización de este handbook, hemos añadido un mapa mental para facilitar la visualización rápida de su estructura.

[Mapa mental del repositorio de manuales de WPES en pdf](assets/Mapa-mental-WPES.pdf)
![Mapa-Mental-WPES](assets/Mapa-mental-handbook-WPES.png)
[Descargar Mapa mental del repositorio de manuales de WPES Ver. 1.0 en pdf](assets/Mapa-mental-WPES-V-1_0.pdf)

![Mapa-Mental-WPES](assets/Mapa-mental-handbook-WPES-V-1_0.png)
Binary file added assets/Mapa-mental-WPES-V-1_0.pdf
Binary file not shown.
Binary file removed assets/Mapa-mental-WPES.pdf
Binary file not shown.
Binary file added assets/Mapa-mental-handbook-WPES-V-1_0.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed assets/Mapa-mental-handbook-WPES.png
Binary file not shown.
27 changes: 17 additions & 10 deletions manual-comunicacion-wordcamps/README.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,25 @@
# "Handbook" de comunicación para WordCamps en España
# Manual de comunicación para WordCamps en España

Dado el creciente número de WordCamps en España, muchos miembros de la comunidad hemos considerado necesario crear un manual de comunicación que facilite las múltiples subtareas que componen esta "gran tarea" a los organizadores.

Este manual se ha creado con el fin de que sea colaborativo, de forma que entre todos lo hagamos crecer, recogiendo las diferentes visiones e ideas que puedan surgir de las diferentes WordCamps celebradas y en pleno proceso de organización a lo largo de España.

## Definición

El Manual de Comunicación establece una guía de trabajo para todas aquellas personas involucradas en tareas de comunicación relativas a la organización de una WordCamp, online o presencial.

## Objetivos del handbook

Sentar las bases de un sistema de calidad.
Para ello es necesario estandarizar el proceso de trabajo que implica gestionar la comunicación antes, durante y después de la organización de una WordCamp.
De esta forma, se facilitará que cualquier miembro pueda contribuir en tareas de comunicación simplemente siguiendo las instrucciones marcadas en este Manual.

## Anexo

Este manual cuenta con un anexo que incluye todas las plantillas necesarias para redactar las distintas comunicaciones. **(Yo crearía un anexo y allí agruparía los distintos formatos, para diferenciar por un lado la guía en sí y por otro las plantillas)**
Este manual cuenta con un anexo que incluye todas las plantillas necesarias para redactar las distintas comunicaciones.

## Fases de una WordCamp

Las fases normales de una WordCamp, las detallamos a continuación:
- [Fase 1.](#fase-1) Previa a la Web.
- [Fase 2.](#fase-2) Publicación de la Web.
Expand All @@ -29,37 +32,40 @@ Las fases normales de una WordCamp, las detallamos a continuación:

A continuación detallaremos las tareas que tendremos que realizar en las fases.

### <a name="fase-1"></a>Fase 1. Previa de la Web
### <a name="fase-1">Fase 1. Previa de la Web</a>

Necesitaremos crear las siguientes páginas:
- Página de inicio.
- Página Código de conducta.
- Página del Venue.

### <a name="fase-2"></a>Fase 2. Publicación de la Web
### <a name="fase-2">Fase 2. Publicación de la Web</a>

- Publicación de la página web.
- Post lanzamiento web
- Comunicación Grupo Meetup

### <a name="fase-3"></a>Fase 3. Llamada a Patrocinadores
### <a name="fase-3">Fase 3. Llamada a Patrocinadores</a>

- [Correo Llamada Patrocinadores](fase-3-llamada-patrocinadores/correo-presentacion-llamada.md).
- [Correo Anteriores Patrocinadores](fase-3-llamada-patrocinadores/correo-antiguos-patrocinadores.md).
- [Correo Recordatorio apertura Llamada patrocinadores](fase-3-llamada-patrocinadores/correo-presentacion-llamada.md).
- [Correo Respuesta Alta Patrocinador](fase-3-llamada-patrocinadores/correo-respuesta-alta.md).

### <a name="fase-4"></a>Fase 4. Llamada a Ponentes
### <a name="fase-4">Fase 4. Llamada a Ponentes</a>

- [Correo a posibles Ponentes para que manden ponencia](fase-4-llamada-ponentes/correo-solicitar-ponencia.md).
- [Correo ponencia seleccionada](fase-4-llamada-ponentes/correo-ponencia-seleccionada.md).
- [Correo ponencia NO seleccionada](fase-4-llamada-ponentes/correo-ponencia-no-seleccionada.md).

### <a name="fase-5"></a>Fase 5. Publicación del Programa
### <a name="fase-5">Fase 5. Publicación del Programa</a>

### <a name="fase-6">Fase 6. Llamada a Voluntarios</a>

### <a name="fase-6"></a>Fase 6. Llamada a Voluntarios
- [Correo Confirmar Voluntario](fase-6-llamada-voluntarios/correo-confirmar-voluntario.md).
- [Correo Voluntario NO seleccionado](fase-6-llamada-voluntarios/correo-voluntario-no-seleccionado.md)

### <a name="fase-7"></a>Fase 7. Recta final
### <a name="fase-7">Fase 7. Recta final</a>

- Nota de prensa.
- Correo a medios.
Expand All @@ -71,7 +77,8 @@ Necesitaremos crear las siguientes páginas:
- [Correo Patrocinadores: asistencia cena](fase-7-recta-final/correo-patrocinadores-asistencia-cena.md).
- [Correo Patrocinadores: envío material](fase-7-recta-final/correo-patrocinadores-envio-material.md).

### <a name="fase-8"></a>Fase 8. Después de la WordCamp
### <a name="fase-8">Fase 8. Después de la WordCamp</a>

- Correo Encuesta a Asistentes.
- [Correo Agradecimiento a los Patrocinadores Retirar material](fase-8-postwordcamp/correo-agradecimiento-patrocinadores-retirar.md)
- [Correo Agradecimiento a los Patrocinadores](fase-8-postwordcamp/correo-agradecimiento-patrocinadores.md).
47 changes: 18 additions & 29 deletions manual-github/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,10 @@

Los manuales de este repositorio son el resultado de un trabajo colaborativo. Para ello es necesario usar herramientas como GitHub, que permite el registro y control de versiones.

Este manual pretende ser una guía de introducción a GitHub para principiantes. Para obtener información más completa se puede visitar la página oficial ![GitHub Documentation](https://docs.github.com/es).
Este manual pretende ser una guía de introducción a GitHub para principiantes. Para obtener información más completa se puede visitar la página oficial [GitHub Documentation](https://docs.github.com/es).

## <a name="top">Guía de uso de Github</a>

<a name="top"></a>
## Guía de uso de Github
1. [Crear una cuenta en GitHub](#paso1)
* 1.1. [Enlazar perfiles WordPress y GitHub](#paso1-1)
2. [Trabajar en repositorio](#paso2)
Expand All @@ -20,8 +20,7 @@ Este manual pretende ser una guía de introducción a GitHub para principiantes.
* 4.3. [Organizar *issues* en Proyectos](#paso4-3)


<a name="paso1"></a>
## 1. Crear una cuenta en GitHub
## <a name="paso1">1. Crear una cuenta en GitHub</a>

Para crearte una cuenta en GitHub, debes ir a su página principal [github.com](https://github.com/) y crearte una cuenta.

Expand All @@ -33,8 +32,7 @@ Una vez que hemos creado nuestra cuenta, ya podemos acceder el repositorio donde

[Volver arriba](#top)

<a name="paso1-1"></a>
### 1.1. Enlazar perfiles WordPress y GitHub
### <a name="paso1-1">1.1. Enlazar perfiles WordPress y GitHub</a>

Para enlazar ambos perfiles es necesario loguearse en https://es.wordpress.org/

Expand All @@ -58,19 +56,17 @@ Se abrirá una ventana como la siguiente donde debemos autorizar el acceso al pe

[Volver arriba](#top)

<a name="paso2"></a>
## 2. Trabajar en repositorio
## 2. <a name="paso2">Trabajar en repositorio</a>

Una vez registrados podemos acceder a la página principal de ![GitHub](https://github.com/) y en la barra lateral aparecerá el listado de repositorios a los que tenemos acceso.
Una vez registrados podemos acceder a la página principal de [GitHub](https://github.com/) y en la barra lateral aparecerá el listado de repositorios a los que tenemos acceso.

Pinchamos en ![WPES/spain-handbook](https://github.com/WPES/spain-handbook) para acceder al repositorio de manuales de WordPress España. En la parte superior izquierda podremos ver en todo momento en qué repositorio estamos.
Pinchamos en [WPES/spain-handbook](https://github.com/WPES/spain-handbook) para acceder al repositorio de manuales de WordPress España. En la parte superior izquierda podremos ver en todo momento en qué repositorio estamos.

Con el fin de evitar posibles errores o conflictos **es importante no trabajar nunca directamente en este repositorio principal**. Para poder editar con seguridad, crearemos una copia del repositorio principal (*fork*) que será donde trabajaremos.

[Volver arriba](#top)

<a name="paso2-1"></a>
### 2.1. Hacer una copia del repositorio en nuestra cuenta de GitHub (*fork*)
### <a name="paso2-1">2.1. Hacer una copia del repositorio en nuestra cuenta de GitHub (*fork*)</a>

Crearemos el *fork* pinchando en el último botón que aparece en la parte superior derecha, está rodeado en azul para que puedas localizarlo más fácilmente.

Expand All @@ -82,11 +78,9 @@ Después de realizarlo, la ventana cambiará y si nos fijamos en la ruta que se

[Volver arriba](#top)

<a name="paso3"></a>
## 3. Edición del archivo
## <a name="paso3">3. Edición del archivo</a>

<a name="paso3-1"></a>
### 3.1. Editar:
### <a name="paso3-1">3.1. Editar:</a>

#### **Para editar:**

Expand All @@ -104,8 +98,7 @@ Si queremos añadir los cambios en nuestro *fork*, dejaremos seleccionada la opc

[Volver arriba](#top)

<a name="paso3-2"></a>
### 3.2 Fetch upstream
### <a name="paso3-2">3.2 Fetch upstream</a>

**Si nuestro *fork* deja de estar actualizado:**

Expand Down Expand Up @@ -139,8 +132,7 @@ A continuación una imagen de lo que nos mostraría la opción *compare*:

[Volver arriba](#top)

<a name="paso3-3"></a>
### 3.3 Pull request
### <a name="paso3-3">3.3 Pull request</a>

Cuando terminamos de editar nuestro archivo podemos proceder a realizar un *pull request*, nuestro archivo se enviará al administrador para su revisión y, una vez realizadas las comprobaciones pertinentes, nuestro *fork* se fusionará con el archivo principal.

Expand Down Expand Up @@ -180,17 +172,16 @@ Dejaremos seleccionada la primera opción si nuestro archivo ya está listo para

[Volver arriba](#top)

<a name="paso4"></a>
## 4. Gestión de proyectos
## <a name="paso4">4. Gestión de proyectos</a>

Al tratarse de un trabajo colaborativo se necesita un alto grado de organización y coordinación.
GitHub nos permite crear *issues*, que son como tareas o acciones que deben realizarse.

Para facilitar la organización, estas *issues* se agrupan por proyectos. Y con el propósito de mantener la coordinación entre los distintos colaboradores, las *issues* pueden asignarse a personas.

[Volver arriba](#top)
<a name="paso4-1"></a>
### 4.1. Crear y personalizar issues

### <a name="paso4-1">4.1. Crear y personalizar issues</a>

En el menú principal de GitHub accedemos al apartado de *Issues* y podemos ver un listado de todas las *issues* ya creadas.
Para crear una nueva *issue* pinchamos en el botón *"New Issue"*.
Expand Down Expand Up @@ -232,8 +223,7 @@ A continuación una imagen de la *issue* una vez editada y guardada

[Volver arriba](#top)

<a name="paso4-2"></a>
### 4.2. Consultar *issues*
### <a name="paso4-2">4.2. Consultar *issues*</a>

Una vez creada la *issue* podemos ir al [repositorio principal](https://github.com/WPES/spain-handbook) y acceder al listado de *issues* pinchando en *Issues*.

Expand All @@ -245,8 +235,7 @@ A continuación podemos ver cómo la *issue* recién creada ya aparece en el lis

[Volver arriba](#top)

<a name="paso4-3"></a>
### 4.3. Organizar *issues* en Proyectos
### <a name="paso4-3">4.3. Organizar *issues* en Proyectos</a>

Si accedemos al apartado de *Projects* desde el menú principal de GitHub podremos ver un listado de todas las etiquetas y en qué estado de realización se encuentra cada una de ellas.

Expand Down
Binary file added manual-github/assets/Card-añadida.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.