GitBook: [master] 86 pages and 110 assets modified

docs/spanish-documentation/getting_started/README.md

@@ -0,0 +1,7 @@
+# Primeros pasos
+
+* [Fork Consul](create.md)
+* [Configure your fork](configuration.md)
+* [Keep your fork updated](update.md)
+* [Communication](communication.md)
+

docs/spanish-documentation/getting_started/communication.md

@@ -0,0 +1,14 @@
+# Comunicación
+
+Para comunicar sugerencias/incidencias te animamos a [abrir una incidencia en el repositorio de Documentación de Consul](https://github.com/consul/consul/issues/new).
+
+Para comunicaciones más informales, chatea con nosotros en el [gitter de consul](https://gitter.im/consul/consul)
+
+Antes de hacerlo, **por favor tómate un tiempo para comprobar los** [**issues ya existentes**](https://github.com/consul/consul/issues) **y asegúrate de que lo que estás a punto de reportar no ha sido reportado previamente** por otra persona. De ser así, si tienes más detalles acerca de la incidencia puedes escribir un comentario en la página ‑¡un poco de ayuda puede marcar una gran diferencia!
+
+Para escribir un nuevo issue, ten en cuenta estas recomendaciones para hacerlo más fácil de leer y comprender:
+
+* Intenta usar un título descriptivo.
+* Es buena idea incluir algunas secciones -en caso de que sean necesarias- como los pasos para reproducir el error, el comportamiento o respuesta que cabría esperar, la respuesta que devuelve o capturas de pantalla.
+* También puede ser de ayuda incluir en la descripción tu sistema operativo, versión del navegador que usaste y posibles plugins instalados.
+

docs/spanish-documentation/getting_started/configuration.md

@@ -0,0 +1,13 @@
+# Configura tu fork
+
+## Travis CI
+
+[Travis](https://travis-ci.org/) es un servicio de Integración Contínua, gratuito para proyectos OpenSource \(como Consul y sus forks\). Te ayudará a vigilar que en las Pull Requests no se rompan los tests.
+
+1. Visita [https://github.com/marketplace/travis-ci](https://github.com/marketplace/travis-ci) y haz click en el botón verde "**Install it for free**"" al pie de la página.
+2. Haz click en el botón verde "**Complete order and begin installation**"
+3. Si se te solicita acceso a tu cuenta de Github por parte de Travis CIaccess, marca la organización o usuario bajo el cual reside tu fork de Consul y haz click en el botón "**Authorize travis-ci**".
+4. Visita [tu perfil en Travis](https://travis-ci.org/profile/) y habilita Travis para tu fork de Consul en el listado de repositorios.
+5. Haz click en el icono de un piñón a la derecha del repositorio para ver las builds.
+6. Comprueba que todo está bien configurado creando un Pull Request de prueba \(editar un simple fichero .md podría servir\).
+

docs/spanish-documentation/getting_started/create.md

@@ -0,0 +1,20 @@
+# Crea tu fork
+
+El repositorio git de Consul está hospedado en Github.com, recomendamos lo uses para tu fork para hacer las cosas mas fáciles. Pero puedes usar cualquier otro servicio como Bitbucket o Gitlab si deseas, pero no te olvides de poner el enlace en el footer a tu repositorio en cumplimiento con la licencia de este proyecto \(GPL Affero 3\).
+
+1. [Registra una cuenta de usuario en Github](https://github.com/join) si no tienes una ya.
+2. [Crea una Organización](https://help.github.com/articles/creating-a-new-organization-from-scratch/) en Github con el nombre de la ciudad u organización que usará Consul. **Esto no es obligatorio**, pero ayudará a entender el propósito del fork y la colaboración de otros usuarios.
+3. [Forkea Consul](https://help.github.com/articles/fork-a-repo/) usando el botón de **fork** en la esquina superior derecha de [https://github.com/consul/consul](https://github.com/consul/consul)
+4. [Clona el repositorio de tu fork](https://help.github.com/articles/cloning-a-repository/) en tu ordenador
+
+**\*\*ADVERTENCIA IMPORTANTE**: No hagas un fork de `https://github.com/AyuntamientoMadrid/consul`, es una equivocación frecuente que conlleva múltiples y graves problemas.
+
+## ¿Porqué hacer el código público?
+
+Recomendamos publicar el código por varias razones:
+
+* **Transparencia**: Debería ser parte de la cultura de aquellas entidades públicas que adopten Consul, así como cualquier organización o grupo.
+* **Soporte**: Si necesitas ayuda técnica, el resto de la comunidad o el equipo de Consul podrán entender y aconsejar mas fácilmente al ver el código implicado.
+* **Colaboración**: Por parte de otros profesionales, ciudadanos, etc...
+* Por último y no menos importante, Consul se distribuye bajo la **licencia** [**AGPLv3**](https://github.com/consul/consul/blob/master/LICENSE-AGPLv3.txt) que obliga a publicar el codigo fuente.
+

docs/spanish-documentation/getting_started/update.md

@@ -0,0 +1,70 @@
+# Manten tu fork actualizado
+
+## Configura tus servidores remotos de git
+
+Si creaste correctamente tu fork y lo clonaste localmente, usando:
+
+```bash
+git remote -v
+```
+
+deberías ver algo como:
+
+> origin git@github.com:your\_user\_name/consul.git \(fetch\)  
+>  origin git@github.com:your\_user\_name/consul.git \(push\)
+
+Ahora debes añadir el repositorio git de CONSUL como servidor remoto con:
+
+```bash
+git remote add upstream git@github.com:consul/consul.git
+```
+
+comprueba de nuevo que con:
+
+```bash
+git remote -v
+```
+
+deberías recibir algo como:
+
+> upstream git@github.com:consul/consul.git \(fetch\)  
+>  upstream git@github.com:consul/consul.git \(push\)  
+>  origin git@github.com:your\_user\_name/consul.git \(fetch\)  
+>  origin git@github.com:your\_user\_name/consul.git \(push\)
+
+## Obteniendo cambios de consul
+
+Empieza creando una rama **upstream** a partir de tu rama **master** sobre la que trabajar:
+
+```bash
+git checkout master
+git pull
+git checkout -b upstream
+```
+
+Y actualiza la información del repositorio de consul con las referencias a las ramas, tags, etc..:
+
+```bash
+git fetch upstream
+```
+
+Y por fin puedes elegir entre:
+
+A. Actualizar con los últimos cambios de la rama **master** usando `git merge upstream/master`
+
+B. Sólo actualizar hasta cierta versión \(en el caso de que prefieras actualizar de forma incremental, si estas varias versiones por detrás\). Por ejemplo para actualizarte a la versión [v0.9](https://github.com/consul/consul/releases/tag/v0.9) utilizamos el tag asociado: `git merge v0.9`
+
+## Fusionando cambios
+
+Tras el `merge` de la anterior sección, hay tres posibles escenarios:
+
+A. Obtienes una respuesta `Already up-to-date.`. Eso significa que tu fork esta al dia con los cambios de CONSUL 😊👌
+
+B. Se abre una ventana del editor que tengas configurado en git, mostrando el mensaje de commit `Merge remote-tracking branch 'upstream/master' into upstream`. Esto significa que git fue capaz de mezclar los cambios de CONSUL sobre tu código sin encontrar problemas o conflictos. Termina el commit.
+
+C. Recibes mensajes de error de git junto con un `Automatic merge failed; fix conflicts and then commit the result.`. Esto significa que se han encontrado conflictos entre los cambios en tu código y los cambios que se realizaron en CONSUL desde la última vez que actualizaste tu fork. Esta es una de las principales razones para intentar mantener tu fork lo más al dia posible, realizando este proceso al menos mensualmente. Resuelve manualmente los conflictos para terminar el merge y haz un commit.
+
+Ahora simplemente sube la rama **upstream** a github y crea un Pull Request, así podrás ver de manera sencilla todos los cambios que se han realizado en el repositorio y verás también como arranca la suite de tests.
+
+Recuerda que siempre puedes comprobar rápidamente los cambios que tienes pendientes de integrar de CONSUL a tu fork sustituyendo **your\_org\_name** en la url: [https://github.com/your\_org\_name/consul/compare/master...consul:master](https://github.com/your_org_name/consul/compare/master...consul:master)
+