Your first contribution

[github-learning-lab]

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]

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 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 principal o 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 fusionadas ^📖 con la rama principal o master.

---

⌨️ Actividad: Tu primera rama

1. Navega a la pestaña titulada Code
2. Haz clic en Branch: master en el desplegable
3. En el campo, ingresa un nombre para tu rama, como mi-rama
4. Haz clic en Create branch: o presiona la tecla "Enter" para crear tu rama

---

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

[github-learning-lab]

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 master. 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. Crea un nuevo archivo en esta rama, en un directorio llamado _posts y llámalo 0000-01-02-marinamuca01.md. Lo puedes hacer usando este atajo o manualmente de la siguiente manera:
   • Regresa a la pestaña "Code"
   • En la lista desplegable de ramas, selecciona "mi-rama"
   • Haz clic en Create new file
   • En el campo "file name", escribe _posts/0000-01-02-marinamuca01.md. Escribir / en el nombre del archivo va a poner tu archivo automáticamente en el directorio _posts.
2. Cuando hayas acabado de nombrar tu archivo, 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!

3. Después de añadir tu texto, puedes hacer una confirmación de cambios al agregar un mensaje de confirmación en el campo text-entry abajo de la vista de edición de archivo. Para más información sobre mensajes de confirmación, comprueba el desplegable Commits 101 , justo arriba de estas instrucciones:
4. Cuando hayas escrito tu mensaje de confirmación , haz clic en Commit new file

---

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

[github-learning-lab]

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 master.

⌨️ 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 "master" esté seleccionada
   • En la lista desplegable llamada "compare:", selecciona "mi-rama"
2. Cuando hayas seleccionado tu rama, escribe un título para tu solicitud de extracción. Por ejemplo Añadir el archivo de marinamuca01
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.