Merge remote-tracking branch 'mberasategi/master' into add-localization

Gemfile.lock

@@ -20,6 +20,7 @@ GEM
     faraday (0.13.1)
       multipart-post (>= 1.2, < 3)
     ffi (1.9.18)
+    ffi (1.9.18-x64-mingw32)
     forwardable-extended (2.6.0)
     gemoji (3.0.0)
     github-pages (155)
@@ -189,6 +190,8 @@ GEM
     net-dns (0.8.0)
     nokogiri (1.8.0)
       mini_portile2 (~> 2.2.0)
+    nokogiri (1.8.0-x64-mingw32)
+      mini_portile2 (~> 2.2.0)
     octokit (4.7.0)
       sawyer (~> 0.8.0, >= 0.5.3)
     parallel (1.12.0)
@@ -224,6 +227,7 @@ GEM
 
 PLATFORMS
   ruby
+  x64-mingw32
 
 DEPENDENCIES
   github-pages
@@ -232,4 +236,4 @@ DEPENDENCIES
   rake
 
 BUNDLED WITH
-   1.15.3
+   1.15.4

_config.yml

@@ -11,7 +11,7 @@ title                    : "On Demand Training"
 title_separator          : "-"
 name                     : "GitHub, Inc."
 description              : "You're in control. We're with you along the way."
-baseurl                  : "/on-demand" # the subpath of your site, e.g. "/blog"
+baseurl                  : "/training-kit" # the subpath of your site, e.g. "/blog"
 gh_repo                  :
 teaser                   : # filename of teaser fallback teaser image placed in /images/, .e.g. "500x300.png"
 breadcrumbs              : true # true, false (default)
@@ -85,3 +85,5 @@ sass:
 
 # Custom site configuration
 lang: en
+
+theme: jekyll-theme-minimal

_data/navigation.yml

@@ -50,6 +50,34 @@ intro-nav:
   - title: "You Completed the GitHub Flow"
     url: /intro-to-github/you-completed-github-flow
 
+intro-nav-es:
+  - title: "Introducción a GitHub"
+    url: /intro-to-github-es/
+  - title: "Crear cuenta GitHub"
+    url: /intro-to-github-es/crear-cuenta-github
+  - title: "Únete al repositorio de la clase"
+    url: /intro-to-github-es/unete-repo-clase
+  - title: "Explora el repositorio GitHub"
+    url: /intro-to-github-es/explora-repositorio
+  - title: "Utiliza el flujo de trabajo GitHub"
+    url: /intro-to-github-es/flujo-github
+  - title: "Creando una rama o branch"
+    url: /intro-to-github-es/creando-rama-branch
+  - title: "Busca tus coordenadas"
+    url: /intro-to-github-es/buscar-coordenadas
+  - title: "Trabajar en GitHub"
+    url: /intro-to-github-es/trabajar-en-github
+  - title: "Crear un Pull Request"
+    url: /intro-to-github-es/crear-pull-request
+  - title: "Colaborar en GitHub"
+    url: /intro-to-github-es/colaborar-en-github
+  - title: "Editar archivos en GitHub"
+    url: /intro-to-github-es/editar-en-github
+  - title: "Hacer Merge de tu Pull Request"
+    url: /intro-to-github-es/merge-pull-requests
+  - title: "Has completado el Flujo GitHub"
+    url: /intro-to-github-es/celebrar
+
 github-desktop-nav:
     - title: "GitHub Pages & GitHub Desktop"
       url: /github-desktop/

_includes/activity/intro-to-github-es/00-crear-cuenta-github.md

@@ -0,0 +1,12 @@
+Para esta clase, necesitarás una cuenta en GitHub.com.
+
+Si ya tienes una cuenta en GitHub.com estás listo para empezar. Si no, puedes obtener tu cuenta gratuita siguiendo esos pasos:
+
+![gif of the following directions](../images/gifs/intro/sign-in.gif)
+
+1. Accede a [GitHub.com](https://github.com) e introduce un nombre de usuario, dirección de correo electrónico y contraseña en los campos correspondientes, y haz clic en **Sign up for GitHub**.
+1. Selecciona la opción **Unlimited public repositories for free** (Repositorios gratuitos ilimitados).
+1. Recibirás un correo de verificación en la dirección indicada.
+1. Haz clic en el enlace que recibirás en ese correo para completar el proceso de verificación.
+
+Si te estás preguntado a dónde ir desde aquí, haz clic en **Dime por qué** para un rápido tour de tu panel de usuario.

_includes/activity/intro-to-github-es/01-unirte-repo-intro.md

@@ -0,0 +1,7 @@
+¡Es hora de ensuciarse las manos! Utiliza estos pasos para acceder a nuestro proyecto compartido:
+
+![gif of the directions]( ../images/gifs/intro/join-repo-make-issue-introduction.gif)
+
+1. Entra en tu cuenta GitHub.
+1. Navega hasta nuestro [proyecto compartido](https://github.com/githubschool/open-enrollment-classes-introduction-to-github/issues/) y haz clic en el botón **New issue**.
+1. Introduce un título para tu issue y haz clic en **Submit new issue**. El usuario GitHubTeacher te añadirá automágicamente a nuestro proyecto como colaborador.

_includes/activity/intro-to-github-es/02-gestionar-notificaciones.md

@@ -0,0 +1,4 @@
+GitHub defaults to over communication and lets you decide what you do and do not want to receive:
+
+1. Scroll to the top of <a href="https://github.com/githubschool/open-enrollment-classes-introduction-to-github/issues/927" target="_blank">issue #927.</a>
+2. On the right side of the issue, click **Unsubscribe** to stop getting email notifications from this discussion.

_includes/activity/intro-to-github-es/03-crear-branch.md

@@ -0,0 +1,10 @@
+Es hora de que crees un branch (o rama) que utilizarás para añadir tu pin al mapa. Así es como se hace:
+
+![gif of directions](../images/gifs/intro/create-branch-intro.gif)
+
+1. Navega a la <a href="https://github.com/githubschool/open-enrollment-classes-introduction-to-github/" target="_blank">pestaña Code</a> en el repositorio de la clase.
+2. Haz clic en el desplegable titulado **Branch: master**.
+3. En el campo, introduce este nombre único para tu branch: `usuario-ciudad` utilizando tu nombre de usuario y tu ciudad.
+4. Haz clic en **Create branch: usuario-ciudad** o presiona Enter para crear tu branch.
+
+> Cuando empiezas a escribir en el campo branch, debería mostrarse un botón azul. Si no lo hace, no eres aún un colaborador en el proyecto y tienes que crear un issue [aquí](https://github.com/githubschool/open-enrollment-classes-introduction-to-github/issues/).

_includes/activity/intro-to-github-es/04-crear-archivo-en-github.md

@@ -0,0 +1,16 @@
+Es momento de añadir tu archivo al repositorio:
+
+![gif of directions](../images/gifs/intro/working-on-github.gif)
+
+1. En tu nuevo branch, añade un archivo nuevo con el nombre `_pins/TU-USUARIO.json`.
+1. Introduce el siguiente contenido en tu archivo:
+
+       ---
+       githubHandle: TU-USUARIO
+       latitude: TU-LATITUD
+       longitude: TU-LONGITUD
+       ---
+
+
+1. Navega hasta la parte inferior e introduce un mensaje de commit que describa tu aportación.
+1. Haz commit de tu cambio a tu branch.

_includes/activity/intro-to-github-es/05-crear-pull-request.md

@@ -0,0 +1,20 @@
+Ahora que has creado un archivo, vas a crear un Pull Request para mostrar los cambios que propones a las demás personas que están completando este proyecto:
+
+![gif of directions](../images/gifs/intro/pull-request-intro.gif)
+
+1. Navega hasta la <a href="https://github.com/githubschool/open-enrollment-classes-introduction-to-github/pulls" target="_blank">pestaña Pull Requests</a>.
+2. Haz clic en `New Pull Request`.
+3. En el desplegable **base**, selecciona `master`.
+4. En el desplegable **compare**, selecciona tu branch.
+5. Haz clic en **Create pull request**.
+6. Puedes dejar el título por defecto o hacerlo más descriptivo.
+7. Utilizando [formato markdown](https://guides.github.com/features/mastering-markdown/) para explicar el trabajo que has hecho en tu branch:
+  - Resume el cambio propuesto.
+  - Menciona al equipo de formadores usando `@githubteacher`.
+  - Utiliza la palabra clave `closes` seguida inmediatamente por el número de tu issue (ej. `closes #3`) para indicar a qué Issue se refiere este Pull Request. Cuando haces esto, el issue se cerrará automáticamente cuando se haga merge del pull request.
+
+   > Los mensajes de Pull Requess son una excelente oportunidad para describir los cambios realizados en el proyecto. Por ejemplo, podrías también incluir información explicando el tipo de feedback que te gustaría que te aportaran los demás u ofreciendo a tus colaboradores una idea de tu planificación temporal para el trabajo.
+   
+8. Haz clic en **Preview** para ver qué aspecto tendrá el Pull Request.
+9. Asígnate el pull request a ti mismo haciendo clic en **assign to yourself** en la sección Assignees.
+10. Haz clic en `Create pull request`.

_includes/activity/intro-to-github-es/05a-colaborar-en-pull-request.md

@@ -0,0 +1,6 @@
+:tada: ¡Enhorabuena! Has creado tu Pull Request. Ahora es momento de ponerte el sombrero de colaborador e ir a ayudar a los demás.
+
+![gif of directions](../images/gifs/intro/collaborate.gif)
+
+1. Ahora que se ha creado tu pull request, vuelve a la lista de pull requests para encontrar un <a href="https://github.com/githubschool/open-enrollment-classes-introduction-to-github/pulls?q=is%3Aopen+is%3Apr" target="_blank">pull request abierto</a> -- que no sea el tuyo.
+2. Ofrece feedback :loudspeaker: y motivación :tada:.

_includes/activity/intro-to-github-es/06-merge-un-pr.md

@@ -0,0 +1,9 @@
+Si todas tus comprobaciones están pasando y no tienes ningún cambio solicitado por otros estudiantes, adelante, puedes hacer merge de tu pull request:
+
+![gif of directions](../images/gifs/intro/merge-intro.gif)
+
+1. Abre tu [Pull Request](https://github.com/githubschool/open-enrollment-classes-introduction-to-github/pulls) para hacer merge.
+1. Navega hasta la parte inferior del Pull Request y haz clic en el botón **Merge pull request**.
+1. Puedes aceptar el mensaje por defecto para el merge commit.
+1. Haz clic en **Confirm merge**.
+1. Haz clic en **Delete branch** para eliminar el branch, dado que ya no contiene una tarea o variación en la que se esté trabajando.

_includes/help-build-fail-es.md

@@ -0,0 +1,22 @@
+## Ayuda: Mi Build ha fallado
+
+El repositorio de la clase está utilizando integración continua a través de [Travis CI](https://travis-ci.org) para hacer tests al código que has enviado. Para simplificar, está comprobando que la sintaxis es correcta en tu archivo.
+
+Los archivos que estamos usando son muy delicados. Si has cometido algún error, verás un mensaje de que tu build ha fallado. Esto generalmente significa que el texto que has introducido es incorrecto. Comprueba la sintaxis con cuidado, compárala con las instrucciones y modifica tu archivo como sea necesario.
+
+Cuando hagas commit de tus cambios, Travis CI volverá a comprobar tu archivo.
+
+Continúa haciendo esto hasta que veas un mensaje de que el build ha pasado. Si necesitas ayuda, no olvides que puedes mencionar a `@githubteacher` en tu pull request.
+
+### Ayuda con problemas específicos
+
+El build puede fallar por diversos motivos. Observar los detalles del log de **Travis CI** puede ayudarte a resolver los problemas en tu código.
+
+1. Abre el _Pull request_
+2. Baja hasta abajo al icon "merge" en la sección donde dice 'checks have failed'.  
+  Aquí verás muchas 'x's rojas :x:. Malo.  
+3. Abre los `Details`  
+
+El log o registro del build de Travis CI puede parecer un poco críptico. Pero con una lectura cuidadosa puede que seas capaz de adivinar la razón por la que tu build está fallando (por cierto, si piensas que el `job log` es críptico, échale un vistazo al `Raw log`).
+
+El script para el build consiste en una serie de comandos. Puede resultar de ayuda saber que **cada nuevo comando empieza con un símbolo `$`**. Dichos comandos pueden ser algo simple o un nuevo (sub)script. Las propiedas individuales de tu _branch_ se testean en scripts individuales. Por ejemplo, **Travis CI** comprueba muy al principio que tu archivo esté formateado de manera apropiada como un "archivo `.yaml`".

_includes/help-gh101-common-es.md

@@ -0,0 +1,29 @@
+### Resolviendo problemas comunes
+
+Hay un par de razones por las que los builds pueden fallar en esta clase. Si tu pull request no está pasando y no se puede hacer merge, comprueba con cuidado lo siguiente:
+
+#### El nombre del archivo es incorrecto
+
+El archivo para la clase debería estar en la carpeta `/_pins` y debería es´tar nombrado como `TU-USUARIO`.json. Comprueba para asegurarte de que:
+
+ - Tu archivo no está en las carpetas `/_pin` o `/pins`.
+ - Tu arhivo no termina con `.jason`, `.md`, `.txt`.
+
+#### El formato del archivo es incorrecto
+
+Los contenidos de tu archivo `.json` deberían tener este aspecto:
+
+  ```
+  ---
+  githubHandle: TU-USUARIO
+  latitude:
+  longitude:
+  ---
+
+  ```
+
+Asegúrate de que:
+
+- Has incluido 3 guiones antes y después de tu código `---` y no `...` o cualquier otro carácter.
+- La `H` en `Handle` es mayúscula.
+- `Handle`, `latitude`, y `longitude` están escritos correctamente.

_includes/help-other-things-es.md

@@ -0,0 +1,7 @@
+## Ayuda: algo va mal
+
+Este es un repositorio ajetreado con muchas contribuciones. Si ves algún mensaje diferente, comprueba esta la guía para resolución de problemas:
+
+| Mensaje | ¿Qué hacer? |
+| -------- | ---------- |
+| **This branch has conflicts and cannot be merged** | Este mensaje te está diciendo que alguien ha realizado cambios en master que entran en conflicto con los cambios que has hecho en tu archivo. No veremos los conflictos en esta clase así que menciona con @ a @githubteacher desde tu Pull Request e intentaremos ayudarte a resolverlo.|

_includes/tell-me-why-es/crear-issue.md

@@ -0,0 +1,20 @@
+## Usando los Issues (problemas/asuntos) en GitHub
+
+Los _Issues_ (literalmente, problemas o asuntos) en GitHub se utilizan para registrar y discutir ideas, mejoras, tareas y errores. Facilitan la colaboración de diferentes maneras:
+
+- Reemplazan al email para discusiones sobre el proyecto, asegurando que todos los miembros del equipo (incluidos los futuros) tengan la historia completa.
+- Permiten enlaces cruzados a otros _Issues_ y _Pull requests_.
+- Crean un registro único y exhaustivo de cómo y por qué tomaste determinadas decisiones.
+- Permiten incluir a las personas adecuadas en la conversación a través de menciones con @ y menciones de equipo.
+
+Para saber más acerca de los _issues_, mira este video:
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/Zhj46r5D0nQ" frameborder="0" allowfullscreen></iframe>
+
+## ¿Por qué te hemos pedido que crees un _Issue_?
+
+Cuando te registras en GitHub, automáticamente tienes **acceso de sólo lectura** a cualquier repositorio público. Esto significa que puedes mirar, comentar _Issues_ y _Pull requests_, y abrir nuevos _Issues_ para notificar errores o solicitar mejoras en tus proyectos favoritos. ¡Incluso puedes crear repositorios en tu propia cuenta!
+
+Sin embargo, no puedes realizar cambios directamente en el proyecto de otra persona, a no ser que utilices un flujo de trabajo específico (llamado "Fork" y "Pull") o te otorguen **acceso como colaborador**.
+
+Para este repositorio, hemos creado un webhook (mecanismo automatizado) que te añado como colaborador cuando creas un _Issue_. Si has completado los pasos de arriba, ¡estás listo para ser colaborador en nuestro proyecto!

_includes/tell-me-why-es/gestionar-notificaciones.md

@@ -0,0 +1,32 @@
+## Gestionando notificaciones
+Una vez has comentado en un _issue_ o _pull request_, empezarás a recibir notificaciones por email. Por defecto, se enviarán notificaciones por email cuando haya actividad en el hilo. 
+También puedes decidir recibir notificaciones de un repositorio completo. Cada vez que haya un _issue_, _pull request_ o _comentario_ nuevo, recibirás una notificación.
+
+### Puedes silenciar o activar notificaciones _individualmente para issues y pull requests_.
+
+1. Accede al issue o pull request.
+2. Haz clic en el botón "(Un)suscribe" de la parte derecha, debajo del botón _Notifications_. Debajo de este botón, una descripción breve explica el estado actual de las notificaciones.
+
+### Puedes _personalizar_ las notificaciones en Settings.
+
+1. Haz clic en tu icono de perfil.
+2. Haz clic en **Settings**.
+3. Haz clic en **Notifications** del menú de la izquierda.
+Aquí puedes ajustar tus [preferencias](https://help.github.com/articles/managing-notification-delivery-methods/) para las notificaciones.
+
+### Puedes elegir recibir notificaciones de un _repositorio_.
+
+* _**Watch**_: Recibirás notificaciones cada vez que un _issue_, _pull request_ o _comentario_ **nuevo** se publique, y también cuando se **cierra** un _issue_ o se hace **merge** de un _pull request_.  
+* _**Not watching**_: Dejar de recibir notificaciones, pero las menciones con  @ se te seguirán enviando.  
+* _**Ignore**_: Detener todas las notificaciones.  
+
+### Puedes _revisar las notificaciones_ para los repositorios que ya estás siguiendo.
+
+1. Haz clic en tu icono de perfil.
+2. Haz clic en **Settings**.
+3. Haz clic en **Notifications** del menú de la izquierda.
+4. Haz clic en el link "[repositories you’re watching](https://github.com/watching)".
+5. Selecciona la pestaña **Watching**.
+6. Haz clic en el botón **(Un)watch** para habilitar o inhabilitar las notificaciones para ese repositorio.
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/ocQldxF7fMY" frameborder="0" allowfullscreen></iframe>