zeke / github-multilingual

A robot powered training repository :robot:
https://github-learning-lab-staging.herokuapp.com/githubtraining/multilingual-introduction-to-github
MIT License
2 stars 0 forks source link

Your first contribution #2

Open ghost opened 5 years ago

ghost commented 5 years ago

Introducción al flujo de GitHub

Ahora que te has familiarizado con issues, usemos este issue para seguir tu camino a tu primera contribución.

Diferentes personas usan diferentes flujos de trabajo para contribuir a proyectos de software, pero la forma más simple y efectiva de contribuir en GitHub es con el flujo de GitHub.

:tv: Video: Entendiendo el flujo de GitHub


Sigue leyendo para ver los siguientes pasos

ghost commented 5 years ago

Paso 4: Crea una rama

Completemos el primer paso del flujo de GitHub : crear una rama :book:.

Creando una rama ## Creando una rama :tv: [Video: Ramas](https://www.youtube.com/watch?v=xgQmu81G1yY) Acabas de aprender cómo crear una rama—el primer paso del flujo de GitHub. Las ramas son una parte importante del flujo de GitHub porque nos permite separar nuestro trabajo de la rama `master`. En otras palabras, el trabajo de todos está a salvo mientras aportas contribuciones. ### Tips para usar ramas Un solo proyecto puede tener cientos de ramas, cada una sugiriendo un nuevo cambio a la rama `master`. La mejor manera de mantener tus ramas organizadas en un equipo es mantenerlas concisas y efímeras. En otras palabras, una sola rama debería representar solamente una nueva característica o una corrección de errores. Esto permite que haya menos confusión entre colaboradores cuando las ramas solamente están activas por unos días antes de que sean unidas [:book:](https://help.github.com/articles/github-glossary/#merge) con la rama `master`.

:keyboard: Actividad: Tu primera rama

  1. Abre tu interfaz de línea de comando preferida, a la cual llamaremos shell de aquí en adelante.
  2. Clona este repositorio:
      git clone https://github.com/zeke/github-multilingual.git
  3. Navega a este repositorio en tu shell:
      cd github-multilingual
  4. Crea una rama, usa el nombre que quieras. Siéntete libre de usar el nombre sugerido a continuación.
      git branch my-slide
  5. Manda la rama a GitHub:
      git push --set-upstream origin <NOMBRE-DE-LA-RAMA>

Responderé cuando haya detectado que una nueva rama ha sido creada en este repositorio.

ghost commented 5 years ago

Paso 5: Commit un archivo

:tada: ¡Haz creado una rama!

Crear una rama te permite hacer modificaciones a tu proyecto sin tener que cambiar la rama master. Ahora que tienes una rama, es hora de crear un archivo y ¡hacer tu primer commit!

Commits 101 ## Commits 101 Cuando hayas terminado de crear o hacer cambios a tu archivo en GitHub, desplázate hasta la parte inferior de la página. Después, encuentra la sección titulada "Commit new file". En el primer campo, escribe un mensaje para tu commit. El mensaje debe informar a tus colaboradores de forma breve sobre los cambios que has introducido al archivo. ### Recomendaciones para los mensajes de commit: - No termines tu mensaje con un punto. - Mantén tu mensaje con 50 o menos caracteres. Si es neceario añade detalles extra en la ventana de descripción extendida. Esta se encuentra justo debajo de la línea de asunto. - Usa la voz activa. Por ejemplo, "añade" en vez de "añadí" y "une" en vez de "uní" - Think of your commit as expressing intent to introduce a change.

:keyboard: Actividad: Tu primer commit

Los siguientes pasos te guiarán a través del proceso de hacer un commit para un cambio en GitHub.

  1. Selecciona tu rama:
      git checkout my-slide
  2. Crea un nuevo archivo llamado _posts/0000-01-02-zeke.md.
  3. Añade el siguiente contenido a tu archivo:
      ---
      layout: slide
      title: "Welcome to our second slide!"
      ---
      Your text
      Use the left arrow to go back!
  4. Añade tu nuevo archivo:
      git add _posts/0000-01-02-zeke.md
  5. Después de añadir tu texto, haz un commit del cambio y agrega un mensaje para el commit, checa el Commits 101 drop-down, justo arriba de estas instrucciones:
      git commit -m "<YOUR-MESSAGE>"
  6. Manda tu nuevo commit a GitHub:
      git push

Responderé cuando haya detectado un nuevo commit en esta rama.

ghost commented 2 years ago

Paso 6: Abre un pull request

Buen trabajo haciendo ese commit :sparkles:

Ahora que has creado un commit, ¡es hora de compartir los cambios que propones por medio de un pull request! Mientras que los issues fomentan la discusión con otros colaboradores de un proyecto, los pull requests te ayudan a compartir tus cambios, recibir notas acerca de tus cambios e iterar tus cambios hasta que estén perfectos!

¿Qué es un pull request? ## Pull requests Pensemos de nuevo en el flujo de GitHub. Has creado una rama, agregaste un archivo, y hiciste un commit del archivo a tu rama. Ahora es hora de colaborar en tu archivo con otros estudiantes que toman esta clase. Esta colaboración sucede dentro de un pull request. Ve este video para aprender más: :tv: [Video: Introducción a pull requests](https://youtu.be/kJr-PIfLDl4)

Este pull request mantendrá los cambios que hiciste dentro de tu rama y propondrá aplicarlos a la rama master.

:keyboard: Actividad: Crea un pull request

  1. Abre un pull request usando este atajo o manualmente así:
    • Desde la pestaña "Pull requests", haz click en New pull request
    • En la lista desplegable llamada "base:", asegúrate que la rama "master" esté seleccionada
    • En la lista desplegable llamada "compare:", selecciona "main"
  2. Cuando hayas seleccionado tu rama, escribe un título para tu pull request. Por ejemplo Add zeke's file
  3. El siguiente campo te ayuda a agregar una descripción de los cambios que has hecho. Agrega una descripción de los cambios que has hecho hasta ahora. Recordatorio, has: creado una rama, creado un archivo e iniciaste un commit, y abriste un pull request
  4. Dale click a Create pull request

Responderé dentro de tu nuevo pull request.