gt2rz / github-slideshow

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

Your first contribution #2

Open github-learning-lab[bot] opened 3 years ago

github-learning-lab[bot] commented 3 years ago

Introducción al flujo de GitHub

Ahora que te has familiarizado con las propuestas (o _issues), usemos esta propuesta para seguir el 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

github-learning-lab[bot] commented 3 years ago

Paso 4: Crea una rama

Completemos el primer paso del flujo de GitHub: crear una rama (o branch) :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 principal o `main`. 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 principal o `main`. 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 fusionadas [:book:](https://help.github.com/articles/github-glossary/#merge) con la rama principal o `main`.

:keyboard: Actividad: Tu primera rama

  1. Abre tu interfaz de línea de comandos (CLI) preferida, a la cual llamaremos shell de aquí en adelante.
  2. Clona este repositorio:
      git clone https://github.com/gt2rz/github-slideshow.git
  3. Navega a este repositorio en tu shell:
      cd github-slideshow
  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. Sube 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.

github-learning-lab[bot] commented 3 years ago

Paso 5: Confirma un archivo

:tada: ¡Haz creado una rama!

Crear una rama te permite hacer modificaciones a tu proyecto sin tener que cambiar la rama main. Ahora que tienes una rama, es hora de crear un archivo y ¡hacer tu primera confirmación de cambios!

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 de confirmación (o _commit message_). El mensaje debe informar a tus colaboradores de forma breve sobre los cambios que has introducido al archivo. ### Recomendaciones para los mensajes de confirmación: - No termines tu mensaje con un punto. - Mantén tu mensaje con 50 o menos caracteres. Si es necesario 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 la funcionalidad xx" en vez de "Añadida la funcionalidad xx" y "Combina los cambios" en lugar de "Combinados los cambios". - Piensa en tu confirmación de cambios como una manera de expresar que quieres introducir una modificación.

:keyboard: Actividad: Tu primera confirmación de cambios (o commit)

Los siguientes pasos te guiarán a través del proceso de hacer una confirmación de cambios (commit) para una modificación en GitHub.

  1. Selecciona tu rama:
      git checkout my-slide
  2. Crea un nuevo archivo llamado _posts/0000-01-02-gt2rz.md.
  3. Añade el siguiente contenido a tu archivo:
      ---
      layout: slide
      title: "Bienvenidos a la segunda página!"
      ---
      Tu texto
      Utiliza la flecha hacia la izquierda para volver!
  4. Añade tu nuevo archivo:
      git add _posts/0000-01-02-gt2rz.md
  5. Después de añadir tu texto, haz una confirmación de cambios y agrega un mensaje de confirmación, comprueba el desplegable Commits 101, justo arriba de estas instrucciones:
      git commit -m "<TU-MENSAJE>"
  6. Manda tu nueva confirmación de cambios a GitHub:
      git push

Responderé cuando haya detectado una nueva confirmación de cambio en esta rama.