Skip to main content

Hola Mundo

Sigue este ejercicio de "Hello World" para iniciar con GitHub.

Introducción

GitHub es una plataforma de hospedaje de código para el control de versiones y la colaboración. Este permite que tú y otras personas trabajen juntos en proyectos desde donde sea.

Este tutorial te enseña lo esencial de GitHub, como los repositorios, ramas, confirmaciones y solicitudes de cambio. Crearás tu propio repositorio de "Hello World" y aprenderás el flujo de trabajo de las solicitudes de cambio de GitHub, una forma popular de crear y revisar código.

En esta guía de inicio rápido:

  • Crearás y utilizarás un repositorio
  • Iniciarás y administrarás una rama nueva
  • Harás cambios a un archivo y los subirás a GitHub como confirmaciones
  • Abrirás y fusionarás una solicitud de cambios

Para completar este tutorial, necesitarás una cuenta de GitHub y acceso a internet. No necesitas saber cómo codificar, utilizar la línea de comandos o instalar Git (el software de control de versiones en el que está compilado GitHub). Si tienes dudas sobre cualquiera de las expresiones que se utilizan en esta guía, dirígete al glosario para encontrar más información sobre nuestra terminología.

Crear un repositorio

Un repositorio se utiliza a menudo para organizar un solo proyecto. Los repositorios pueden contener carpetas y archivos, imágenes, videos, hojas de cálculo y conjuntos de datos; todo lo que necesita tu proyecto. A menudo, los repositorios incluyen un archivo de README, que es un archivo con información sobre tu proyecto. Los archivos README se escriben en el lenguaje de marcado de texto simple. Puedes utilizar esta hoja informativa para iniciar con la sintaxis de lenguaje de marcado. GitHub te permite agregar un archivo de README al mismo tiempo que creas tu repositorio nuevo. GitHub también ofrece otras opciones comunes, tales como un archivo de licencia, pero no teines que seleccionar ninguna de ellas ahora mismo.

Tu repositorio de hello-world puede ser un lugar donde almacenes ideas, recursos o incluso compartas y debatas cosas con los demás.

  1. En la esquina superior derecha de cualquier página, utiliza el menú desplegable y selecciona Repositorio Nuevo. Menú desplegable con opción para crear un repositorio nuevo

  2. En la caja de Nombre de repositorio, ingresa hello-world.

  3. En la caja de Descripción, escribe una descripción corta.

  4. Selecciona Agregar un archivo README.

  5. Selecciona si tu repositorio será Público o Privado.

  6. Haz clic en Crear repositorio.

    Crear un repositorio de hello world

Cómo crear una rama

La ramificación te permite tener versiones diferentes de un repositorio en una ocasión.

Predeterminadamente, tu repositorio tiene una rama llamada main, la cual se considera como la rama definitiva. Puedes crear ramas adicionales de la main en tu repositorio. Puedes utilizar ramas para tener versiones diferentes de un proyecto en algún momento específico. Esto es útil cuando quieres agregar características nuevas a un proyecto sin cambiar la fuente de código principal. El trabajo que se hace en las diferentes ramas no se mostrará en la rama principal sino hasta que la fusiones, lo cual veremos más adelante en esta guía. Puedes utilizar ramas para experimentar y hacer ediciones antes de confirmarlas a main.

Cuando creas una rama fuera de la de main, estás haciendo una copia o captura de pantalla de main como lo fue en ese momento. Si alguien más hizo cambios en la rama main mientras estuviste trabajando en tu rama, podrías extraer esas actualizaciones.

Este diagrama muestra:

  • La rama main
  • Una rama nueva llamada feature
  • El viaje que hace feature antes de fusionarse en main

diagrama de ramificado

¿Alguna vez has guardado versiones distintas de un archivo? Algo como:

  • story.txt
  • story-edit.txt
  • story-edit-reviewed.txt

Las ramas logran metas similares en los repositorios de GitHub.

En GitHub, nuestros desarrolladores, escritores y diseñadores utilizan ramas para mantener las correcciones de errores y el trabajo de las características separados de nuestra rama main (productiva). Cuando un cambio está listo, se fusiona su rama en main.

Crear una rama

  1. Haz clic en la pestaña de Código de tu repositorio hello-world.
  2. Haz clic ene l menú desplegable en la parte superior del archivo que dice main. Menú de la rama
  3. Teclea un nombre de rama, readme-edits, en la caja de texto.
  4. Haz clic en Crear rama: readme-dits desde main.

Menú de la rama

Ahora tienes dos ramas, main y readme-edits. Ahora mismo, se ven idénticas. A continuación, agregarás cambios a la rama nueva.

Hacer y confirmar cambios

Cuando creaste una rama nueva en el paso anterior, GitHub te llevó a la página de código de tu rama readme-edits nueva, la cual es una copia de main.

Puedes hacer y guardar cambios a los archivos de tu repositorio. En GitHub, los cambios guardados se llaman confirmaciones. Cada confirmación tiene un mensaje de confirmación asociado, el cual es una descripción que explica por qué se realizó algún cambio en particular. Los mensajes de confirmación capturan la historia de tus cambios para que otros contribuyentes puedan entender lo que hiciste y por qué.

  1. Debajo de la rama readme-edits que creaste, haz clic en el archivo README.md.

  2. Haz clic en para editar el archivo.

  3. En el editor, escribe un poco sobre ti mismo. Intenta utilizar elementos de lenguaje de marcado diferentes.

  4. En la caja de Cambios de confirmación, escribe un mensaje de confirmación que describa tus cambios.

  5. Haz clic en Commit changes (Confirmar cambios).

    Ejemplo de confirmación

Estos cambios se harán únicamente al archivo README en tu rama readme-edits, así que ahora esta rama tiene contenido que es diferente de la de main.

Abrir una solicitud de extracción

Ahora que tienes cambios en una rama furea de la de main, puedes abrir una solicitud de cambios.

Las solicitudes de cambios son el núcleo de la colaboración en GitHub. Cuando abres una solicitud de cambios, estás proponiendo tus cambios y solicitando que alguien revise e integre tu contribución y la fusione en su rama. Las solicitudes de cambio muestran diffs o diferencias del contenido de ambas ramas. Los cambios, adiciones y sustracciones se muestran en varios colores.

Tan pronto hagas una confirmación, puedes abrir una solicitud de cambios y comenzar un debate, incluso antes de que se termine el código.

Si utilizas la característica de @mention de GitHub en tu mensaje de solicitud de cambios, puedes pedir retroalimentación de una persona o equipo específico, ya sea que estén al fondo del pasillo o a 10 zonas horarias de distancia.

Incluso puedes abrir solicitudes de cambio en tu propio repositorio y fusionarlas tú mismo. Es una forma genial para aprenderse el flujo de GitHub antes de trabajar en proyectos más grandes.

  1. Haz clic en la pestaña de Solicitudes de cambios de tu repositorio hello-world.

  2. Haz clic en Solicitud de cambios nueva

  3. En la caja de Comparaciones de ejemplo, selecciona la rama que hiciste, readme-edits, para compararla con main (la original).

  4. Mira tus cambios en los diffs en la página de Comparar, asegúrate que son lo que quieres enviar.

    ejemplo de diff

  5. Haz clic en Create Pull Request (Crear solicitud de extracción).

  6. Dale un título a tu solicitud de cambios y escribe una descripción breve de estos. Puedes incluir emojis y arrastrar y soltar imágenes y gifs.

  7. Opcionalmente, a la derecha de tu título y descripción, haz clic en el junto a Revisores. Asignados, Etiquetas, Proyectos o Hito para agregar cualquiera de estas opciones a tu solicitud de cambios. No necesitas agregar ninguna aún, pero estas opciones ofrecen diversas formas de colaborar utilizando solicitudes de cambio. Para obtener más información, consulta "Acerca de las solicitudes de extracción."

  8. Haz clic en Create Pull Request (Crear solicitud de extracción).

Tus colaboradores ahora pueden revisar tus ediciones y hacer sugerencias.

Fusionar tu solicitud de cambios

En este paso final, fusionarás tu rama de readme-edits en la rama main. Después de que fusionas tu solicitud de cambios, los cambios en tu rama de readme-edits se incorporarán a main.

Algunas veces, una solicitud de cambios podría introducir cambios al código que entren en conflicto con el existente en main. Si existe cualquier conflicto, GitHub te alertará sobre el código que lo ocasiona y no dejará que se fusione sino hasta que esto se resuelva. Puedes hacer una confirmación que resuelva los conflictos o que utilice comentarios en la solicitud de cambios para debatir estos conflictos con tus miembros de equipo.

En este recorrido, no deberías de tener conflictos, así que estás listo para fusionar tu rama en la principal.

  1. Haz clic en Fusionar solicitud de cambios para fusionar los cambios en main. Captura de pantalla del botón de fusión.
  2. Haz clic en Confirmar fusión. Recibirás un mensaje indicando que la solicitud se fusionó con éxito y luego se cerró.
  3. Haz clic en Borrar rama. Ahora que tu solicitud de cambios se fusionó y tus cambios están en main, puedes borrar la rama readme-edits con seguridad. Si quieres hacer más cambios a tu proyecto, siempre puedes crear una rama nueva y repetir este proceso.

Pasos siguientes

Al haber completado este tutorial, aprendiste a crear un proyecto y hacer una solicitud de cambios en GitHub.

Esto es lo que lograste en este tutorial:

  • Creaste y abriste un repositorio de código fuente
  • Iniciaste y administraste una rama nueva
  • Cambiaste un archivo y confirmaste esos cambios en GitHub
  • Abriste y fusionaste una solicitud de cambios

Echa un vistazo a tu perfil de GitHub y verás tu trabajo reflejado en tu gráfica de contribuciones.

Para obtener más información sobre el poder de las ramas y las solicitudes de cambios, consulta la sección "Flujo de GitHub". Para obtener más información sobre cómo iniciar con GitHub, consulta el resto de las guías en la guía rápida de inicio.