Tutorial de GitHub
Guía colaborativa para dominar GitHub, elaborada por estudiantes de la UNALM.
📚 Contenido
1. Introducción
GitHub es la plataforma por excelencia para colaborar en proyectos de software. Más que un lugar para guardar código, es una red global que facilita el trabajo en equipo, el control de versiones y la innovación abierta. En esta sección descubrirás cómo GitHub ha transformado la forma de desarrollar software en todo el mundo.
2. Issues
Los Issues en GitHub permiten organizar el trabajo colaborativo: puedes reportar errores, proponer mejoras, asignar tareas o hacer preguntas. Son clave para planificar y dar seguimiento al desarrollo de un proyecto. En esta sección aprenderás a crearlos, asignarlos, cerrarlos y usar buenas prácticas con ejemplos reales.
3. Pull Requests
Los Pull Requests (PR) son fundamentales en el trabajo colaborativo con GitHub. Permiten proponer cambios desde una rama hacia otra (como main) para que otros puedan revisarlos antes de ser aceptados. En esta sección aprenderás cómo crear un PR desde la terminal y la interfaz web, cómo revisarlos correctamente, aprobarlos y fusionarlos de forma segura. También se incluyen buenas prácticas para revisiones de código, como detectar errores, sugerir mejoras y fomentar el aprendizaje dentro del equipo.
4. GitHub Projects
GitHub Projects permite gestionar tareas usando tableros tipo Kanban directamente en tu repositorio. En este tutorial, usamos esta herramienta para organizar el trabajo en equipo, distribuir responsabilidades y hacer seguimiento al avance de cada sección. Verás cómo configuramos el tablero, cómo se distribuyeron las tareas y qué beneficios trajo para mantenernos organizados y enfocados.
5. Automatización con GitHub Actions
Explica qué es y un ejemplo sencillo (por ejemplo, acción que despliegue una web).
6. GitHub Gists
GitHub Gist es una herramienta para crear y compartir fragmentos de código o notas de texto de forma rápida y sencilla. Permite guardar archivos públicos o privados, colaborar con otros, y es útil para ejemplos, pruebas o documentación sin necesidad de un repositorio completo.
7. GitHub Pages
GitHub Pages permite transformar tu repositorio en un sitio web navegable y profesional. En este proyecto lo utilizamos para publicar el tutorial como una guía web, aplicando diseño personalizado con SCSS, una navegación clara desde index.md, y configuración precisa con _config.yml. Esta sección te enseñará cómo hacerlo desde cero y cómo aprovecharlo como portafolio o documentación viva.
8. Codespaces y Dev Editor
GitHub Codespaces es un entorno de desarrollo online que te permite programar directamente desde el navegador, sin necesidad de instalar VS Code ni herramientas adicionales. Puedes trabajar con Python, R, JavaScript y más, guardando tus archivos y cambios en tu repositorio de GitHub. Es perfecto para programar desde cualquier dispositivo con conexión a internet.
9. Conclusión
Dominar GitHub es mucho más que saber usar comandos: es comprender cómo colaborar, compartir y construir proyectos de forma profesional. En esta sección encontrarás una reflexión final sobre todo lo aprendido, la importancia del control de versiones, el trabajo en equipo y cómo GitHub se ha convertido en una herramienta esencial para cualquier desarrollador o estudiante de tecnología.
10. Créditos
👨💻 Jhon Villegas
👨💻 Alonso Coronado
👨💻 Fernando Ruiz
🔗 Repositorio en GitHub
📅 Mayo 2025