Unidad 8 – Buenas prácticas en proyectos reales

Propósito de la unidad

En un proyecto real no basta con saber usar Git. También es necesario decidir qué archivos sí deben formar parte del repositorio, cuáles no deben subirse, cómo organizar las carpetas del proyecto y cómo hacer cambios sin afectar la estabilidad de la aplicación.

Esta unidad busca que el estudiante comprenda que versionar no significa “subir todo”, sino mantener bajo control únicamente lo necesario para desarrollar, colaborar, respaldar y desplegar un sistema de forma ordenada.

Aprendizajes esperados

Al finalizar la unidad, el estudiante será capaz de:

• Identificar qué archivos deben versionarse en un proyecto.
• Distinguir archivos temporales, confidenciales o generados automáticamente que no deben subirse al repositorio.
• Crear y configurar correctamente un archivo .gitignore.
• Organizar un proyecto con una estructura más profesional.
• Realizar una actualización controlada sin poner en riesgo la estabilidad del sistema.

¿Que debe versionarse?

Cuando trabajamos con Git, no todos los archivos tienen el mismo valor. Algunos contienen el código fuente, la configuración básica o la documentación del proyecto. Esos archivos sí deben formar parte del repositorio porque permiten reconstruir, entender y continuar el trabajo.

Archivos que normalmente sí deben versionarse:

1. Código fuente: son los archivos principales del sistema.
2. Archivos de configuración base: necesarios para que el proyecto pueda montarse en otro equipo, siempre que no incluyan datos sensibles.
3. Recursos del proyecto (imágenes, iconos, documentos técnicos del proyecto)

Archivos que normalmente no deben versionarse:

Hay archivos que se generan automáticamente, contienen información privada o son temporales. Subirlos puede causar desorden, errores o riesgos de seguridad.

1. Archivos temporales: se crean durante la ejecución del sistema o por el editor.
2. Archivos sensibles o privados (contraseñas, claves API, tokens, certificados)
3. Archivos generados automáticamente (carpetas de dependencias, archivos compilados, cache de frameworks, archivos exportados, binarios generados)