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

Your first contribution #2

Closed
github-learning-lab bot opened this issue Jul 21, 2021 · 3 comments
Closed

Your first contribution #2

github-learning-lab bot opened this issue Jul 21, 2021 · 3 comments

Comments

@github-learning-lab
Copy link

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.

📺 Video: Entendiendo el flujo de GitHub


Sigue leyendo para ver los siguientes pasos

@github-learning-lab
Copy link
Author

Paso 4: Crea una rama

Completemos el primer paso del flujo de GitHub: crear una rama (o branch) 📖.

Creando una rama

Creando una rama

📺 Video: Ramas

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 📖 con la rama principal o main.


⌨️ 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/Aleix88/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
Copy link
Author

Paso 5: Confirma un archivo

🎉 ¡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.

⌨️ 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-Aleix88.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-Aleix88.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.

@github-learning-lab
Copy link
Author

Paso 6: Abre una solicitud de extracción

Buen trabajo haciendo esa confirmación de cambios ✨

Ahora que has creado una confirmación de cambios, ¡es hora de compartir los cambios que propones por medio de una solicitud de extracción (o pull request)! Mientras que las propuestas (issues) fomentan la discusión con otros colaboradores de un proyecto, las solicitudes de extracción (pull requests) te ayudan a compartir tus cambios, recibir notas acerca de tus cambios y seguir trabajando en tus cambios ¡hasta que estén perfectos!

¿Qué es una solicitud de extracción?

Solicitudes de extracción (o pull requests)

Pensemos de nuevo en el flujo de GitHub. Has creado una rama, agregaste un archivo, e hiciste una confirmación de cambios de ese archivo en tu rama. Ahora es hora de colaborar en tu archivo con otros estudiantes que toman esta clase. Esta colaboración sucede dentro de una solicitud de extracción. Mira este video para aprender más:

📺 Video: Introducción a las solicitudes de extracción


Esta solicitud de extracción mantendrá los cambios que hiciste dentro de tu rama y propondrá aplicarlos a la rama main.

⌨️ Actividad: Crea una solicitud de extracción

  1. Abre una solicitud de extracción usando este atajo o manualmente, así:
    • Desde la pestaña "Pull requests", haz clic en New pull request
    • En la lista desplegable llamada "base:", asegúrate que la rama "main" esté seleccionada
    • En la lista desplegable llamada "compare:", selecciona "my-slide"
  2. Cuando hayas seleccionado tu rama, escribe un título para tu solicitud de extracción. Por ejemplo Añadir el archivo de Aleix88
  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 iniciado la confirmación de cambios correspondiente y por último has abierto una solicitud de extracción
  4. Haz clic en Create pull request

Responderé dentro de tu nueva solicitud de extracción.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

0 participants