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 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. Navega a la pestaña titulada Code
2. Haz clic en Branch: main 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 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. Crea un nuevo archivo en esta rama, en un directorio llamado _posts y llámalo 0000-01-02-fedeadrianv.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 "My_main"
   • Haz clic en Create new file
   • En el campo "file name", escribe _posts/0000-01-02-fedeadrianv.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.