El proyecto Hello World es una tradición consagrada en la programación informática. Es un ejercicio sencillo que te hace empezar cuando aprendes algo nuevo. Vamos a empezar con GitHub!
Aprenderás a:
- Crear y utilizar un repositorio
- Iniciar y gestionar una nueva rama
- Hacer cambios en un archivo y empujarlos a GitHub como commits
- Abrir y fusionar un pull request
¿Qué es GitHub?
GitHub es una plataforma de alojamiento de código para el control de versiones y la colaboración. Te permite a ti y a otros trabajar juntos en proyectos desde cualquier lugar.
Este tutorial te enseña lo esencial de GitHub, como repositorios, ramas, commits y Pull Requests. Crearás tu propio repositorio Hello World y aprenderás el flujo de trabajo Pull Request de GitHub, una forma popular de crear y revisar código.
No es necesario codificar
Para completar este tutorial, necesitas una cuenta de GitHub.com y acceso a Internet. No necesitas saber codificar, usar la línea de comandos o instalar Git (el software de control de versiones en el que se basa GitHub).
Consejo: Abre esta guía en otra ventana del navegador (o pestaña) para poder verla mientras completas los pasos del tutorial.
Paso 1. Crear un Repositorio
Un repositorio se suele utilizar para organizar un único proyecto. Los repositorios pueden contener carpetas y archivos, imágenes, vídeos, hojas de cálculo y conjuntos de datos, cualquier cosa que tu proyecto necesite. Te recomendamos que incluyas un README, o un archivo con información sobre tu proyecto. GitHub hace que sea fácil añadir uno al mismo tiempo que creas tu nuevo repositorio. También ofrece otras opciones comunes como un archivo de licencia.
Tu hello-world repositorio puede ser un lugar donde almacenar ideas, recursos, o incluso compartir y discutir cosas con otros.
Para crear un nuevo repositorio
- En la esquina superior derecha, junto a tu avatar o identicon, haz clic y luego selecciona Nuevo repositorio.
- Nombre su repositorio
hello-world. - Escriba una breve descripción.
- Seleccione Inicializar este repositorio con un LÉAME.
Haga clic en Crear repositorio.
Paso 2. Crear una rama
La ramificación es la forma de trabajar en diferentes versiones de un repositorio a la vez.
Por defecto tu repositorio tiene una rama llamada main que se considera la rama definitiva. Utilizamos las ramas para experimentar y hacer ediciones antes de confirmarlas en main.
Cuando creas una rama a partir de la rama main, estás haciendo una copia, o instantánea, de main tal y como estaba en ese momento. Si alguien más hiciera cambios en la rama main mientras estás trabajando en tu rama, podrías tirar de esas actualizaciones.
Este diagrama muestra:
- La rama
main - Una nueva rama llamada
feature(porque estamos haciendo «trabajo de características» en esta rama) - El viaje que
featurehace antes de ser fusionado enmain
¿Has guardado alguna vez diferentes versiones de un archivo? Algo así como:
story.txtstory-joe-edit.txtstory-joe-edit-reviewed.txt
Las ramas cumplen objetivos similares en los repositorios de GitHub.
Aquí en GitHub, nuestros desarrolladores, escritores y diseñadores utilizan ramas para mantener las correcciones de errores y el trabajo de las características separadas de nuestra main rama (de producción). Cuando un cambio está listo, fusionan su rama en main.
Para crear una nueva rama
- Ve a tu nuevo repositorio
hello-world. - Haz clic en el desplegable de la parte superior de la lista de archivos que dice rama: principal.
- Escriba un nombre de rama,
readme-edits, en el cuadro de texto de nueva rama. - Seleccione el cuadro azul Crear rama o pulse «Intro» en su teclado.
Ahora tienes dos ramas, main y readme-edits. Se ven exactamente igual, ¡pero no por mucho tiempo! A continuación añadiremos nuestros cambios a la nueva rama.
Paso 3. Haz y confirma los cambios
¡Bravo! Ahora, estás en la vista de código de tu rama readme-edits, que es una copia de main. Vamos a hacer algunas ediciones.
En GitHub, los cambios guardados se llaman commits. Cada commit tiene un mensaje de commit asociado, que es una descripción que explica por qué se hizo un cambio en particular. Los mensajes de confirmación capturan el historial de tus cambios, para que otros colaboradores puedan entender qué has hecho y por qué.
Hacer y confirmar cambios
- Haz clic en el archivo
README.md. - Haz clic en el icono del lápiz en la esquina superior derecha de la vista del archivo para editar.
- En el editor, escribe un poco sobre ti.
- Escribe un mensaje de confirmación que describa tus cambios.
- Haz clic en el botón Confirmar cambios.
Estos cambios se harán sólo en el archivo README de tu rama readme-edits, por lo que ahora esta rama tiene un contenido diferente al de main.
Paso 4. Abrir un Pull Request
¡Buenas ediciones! Ahora que tienes cambios en una rama de main, puedes abrir un pull request.
Los pull requests son el corazón de la colaboración en GitHub. Cuando abres una solicitud de extracción, estás proponiendo tus cambios y solicitando que alguien revise y extraiga tu contribución y la fusione en su rama. Los pull requests muestran los diffs, o diferencias, del contenido de ambas ramas. Los cambios, adiciones y sustracciones se muestran en verde y rojo.
Tan pronto como hagas un commit, puedes abrir un pull request e iniciar una discusión, incluso antes de que el código esté terminado.
Al utilizar el sistema de @menciones de GitHub en tu mensaje de pull request, puedes pedir comentarios a personas o equipos específicos, ya sea que estén al final del pasillo o a 10 zonas horarias de distancia.
Incluso puedes abrir pull requests en tu propio repositorio y fusionarlos tú mismo. Es una gran manera de aprender el flujo de GitHub antes de trabajar en proyectos más grandes.
Abrir una Pull Request para cambios en el README
Haz clic en la imagen para verla más grande
| Paso | Captura de pantalla |
|---|---|
| Haz clic en la pestaña Pull Request, luego desde la página de Pull Request, haz clic en el botón verde New pull request. |  |
En el cuadro de comparaciones de ejemplo, selecciona la rama que hiciste, readme-edits, para compararla con main (la original). |
 |
| Revisa tus cambios en los diffs de la página Comparar, asegúrate de que son los que quieres enviar. |  |
| Cuando estés satisfecho de que estos son los cambios que quieres enviar, haz clic en el gran botón verde Create Pull Request. |  |
| Da un título a tu pull request y escribe una breve descripción de tus cambios. |  |
Cuando hayas terminado con tu mensaje, ¡haz clic en Crear pull request!
Consejo: Puedes utilizar emoji y arrastrar y soltar imágenes y gifs en los comentarios y Pull Requests.
Paso 5. Fusiona tu Pull Request
En este último paso, es el momento de unir tus cambios – fusionando tu readme-edits rama en la main rama.
- Haz clic en el botón verde Merge pull request para fusionar los cambios en
main. - Haz clic en Confirm merge.
- Adelante, elimina la rama, ya que sus cambios han sido incorporados, con el botón Delete branch en el cuadro morado.¡
¡Celebración!
Al completar este tutorial, has aprendido a crear un proyecto y hacer un pull request en GitHub!
Esto es lo que has conseguido en este tutorial:
- Crear un repositorio de código abierto
- Iniciar y gestionar una nueva rama
- Cambiar un archivo y confirmar esos cambios en GitHub
- Abrir y fusionar un Pull Request
¡Echa un vistazo a tu perfil de GitHub y verás tus nuevos cuadros de contribución!
0 comentarios