En este módulo, aplicarás conceptos y herramientas de Git y GitHub en un proyecto final. A lo largo de este módulo, aprenderás a organizar, documentar y colaborar en un repositorio de GitHub de manera profesional.
8.1 Creación de un repositorio de proyecto en GitHub
Objetivo:
Crear un repositorio en GitHub que servirá como base para el proyecto final.
- Creación del repositorio:
- Inicia sesión en GitHub y dirígete a la pestaña de Repositories.
- Selecciona New para crear un nuevo repositorio.
- Nombra el repositorio y, si deseas, añade una breve descripción. Escoge si quieres que sea público o privado y marca la opción para agregar un archivo README.
- Clonación del repositorio en tu sistema local:
- Copia la URL del repositorio desde GitHub.
- En la terminal, usa el comando:
git clone URL_DEL_REPOSITORIO - Navega al directorio del repositorio para comenzar a trabajar en el proyecto.
8.2 Desarrollo de características en ramas separadas
Objetivo:
Crear ramas separadas para desarrollar y probar diferentes características del proyecto sin afectar la rama principal.
- Creación de una nueva rama:
- Desde el directorio del proyecto, crea una rama para cada nueva característica o tarea:
git checkout -b nombre_rama - Este comando crea y cambia a la nueva rama, en la que puedes desarrollar la característica sin interferir con
main(rama principal).
- Desde el directorio del proyecto, crea una rama para cada nueva característica o tarea:
- Subir una rama a GitHub:
- Una vez desarrollada la característica, sube la rama a GitHub:
git push origin nombre_rama - Esto te permitirá crear una Pull Request para revisar los cambios en GitHub.
- Una vez desarrollada la característica, sube la rama a GitHub:
8.3 Creación y revisión de Pull Requests
Objetivo:
Solicitar una revisión de los cambios propuestos mediante una Pull Request (PR) y aprender a colaborar en la revisión de código.
- Crear una Pull Request en GitHub:
- Ve a la página del repositorio en GitHub y selecciona la pestaña Pull Requests.
- Haz clic en New Pull Request y selecciona la rama que has creado.
- Agrega un título y una descripción de los cambios, explicando su propósito y cualquier detalle importante.
- Revisar y aprobar cambios:
- Los colaboradores pueden dejar comentarios en la Pull Request, realizar sugerencias y aprobar los cambios.
- Si es necesario realizar ajustes, puedes modificar el código en tu rama local y hacer un nuevo
pushpara actualizar la Pull Request.
- Merge de la Pull Request:
- Una vez que todos aprueben los cambios, realiza el merge de la Pull Request a la rama principal (main).
- Este proceso permite mantener un historial claro y registrar quién revisó y aprobó cada cambio.
8.4 Documentación del proyecto en GitHub (README, Issues)
Objetivo:
Aprender a documentar un proyecto y gestionar tareas mediante Issues en GitHub.
- Crear y actualizar un archivo README:
- El archivo README es esencial para que los demás comprendan el objetivo, la instalación y el uso del proyecto.
- Incluye secciones básicas como la descripción del proyecto, instrucciones de instalación, y cualquier otra información relevante.
- Abrir Issues para gestionar tareas y reportar problemas:
- Usa Issues para listar tareas pendientes, mejoras o problemas del proyecto.
- Crea un nuevo issue en la pestaña Issues y describe la tarea o problema. Puedes asignar etiquetas y colaboradores para organizar mejor el trabajo.
- Organización adicional con tableros de Proyectos:
- En la pestaña Projects, crea un tablero para el proyecto y añade los issues como tarjetas en el tablero para un seguimiento visual del progreso.