search

matiasobregon / 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. Descarga y abre Visual Studio Code (referido como VS Code) si aún no lo tienes.
  2. En VS Code, abre la Paleta de Comandos (o Command Palette) usando Ctrl+Mayús+P en Windows, o Command ⌘+Mayús+P en macOS. También puedes seguir la documentación oficial de VS Code sobre clonar repositorios.
  3. Escribe git cloney presiona Enter una captura de pantalla de VS Code con la Paleta de Comandos abierta
  4. Pega la URL del repositorio en la nueva ventana y presiona Enter: 
      https://github.com/matiasobregon/github-slideshow.git
  5. Selecciona la ubicación en el que quieres guardar el repositorio y haz clic en Choose folder. Después, abre la ubicación que seleccionaste.
  6. El directorio del repositiorio debería estar ahora abierto en tu proyecto de VS Code. Haz clic en main en la parte inferior de la ventana de VS Code. Esto abrirá la Paleta de Comandos con todos los comandos relacionados a ramas de Git. una captura de pantalla de las ramas de Git en VS Code
  7. Haz clic en Create new branch e ingresa cualquier nombre que le quieras dar a tu rama, como mi-rama. A continuación, presiona Enter.
  8. Cuando te hagan seleccionar la rama que servirá de referencia para tu nueva rama, selecciona main.
  9. Ve a la vista de Source Control, haz clic en los punto suspensivos (...) y selecciona Push. En la caja de diálogo preguntándote si quieres publicar tu rama, confirma que sí. una captura de pantalla de la vista de Source Control en VS Code

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. En el directorio _posts , crea un nuevo archivo llamado 0000-01-02-matiasobregon.md. La ruta completa a tu archivo será: _posts/0000-01-02-matiasobregon.md.
  2. Añade el siguiente contenido a tu archivo y guárdalo: 
      ---
  layout: slide
  title: "Bienvenidos a la segunda página!"
  ---
  Tu texto
  Utiliza la flecha hacia la izquierda para volver!
  3. Para añadir tu nuevo archivo ve a la vista de Source Control y haz clic en el botón + a lado del archivo. También puedes seguir este paso con la documentación oficial de VS Code. una captura del botón de staging en la vista Source Control
  4. Haz una confirmación de cambios escribiendo un mensaje de confirmación en el campo de texto y después presionandoCtrl+Enter en Windows o Comando ⌘+Enter en macOS. una captura del mensaje de confirmación de cambios VS Code
  5. Haz clic en los puntos suspensivos (...) y selecciona Push.

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