A5. Git

En esta actividad se utilizará Git para comenzar a mantener un historial de los cambios realizados en la documentación creada durante la unidad.

Continuaremos trabajando sobre el directorio:

usuario-sistemas/docs

Este directorio se convertirá en un repositorio Git y contendrá tanto la documentación como el historial de los cambios realizados.

1. Comprobar Git

Abre una terminal y comprueba que Git está instalado en el sistema.

Consulta su versión.

Comprueba también la configuración actual de Git e identifica, al menos:

user.name
user.email

Si estos datos no están configurados correctamente, establece el nombre y correo electrónico que utilizarás para identificar tus commits.

Documenta las comprobaciones y configuraciones realizadas.

2. Crear el repositorio

Sitúate mediante la terminal en:

usuario-sistemas/docs

Este directorio será la raíz del repositorio Git.

Inicializa un nuevo repositorio Git.

Comprueba posteriormente su estado e identifica qué rama estás utilizando.

Directorio .git

Al inicializar Git se crea dentro del proyecto un directorio especial:

.git

Este directorio contiene la información utilizada por Git para gestionar el repositorio y su historial.

No modifiques manualmente su contenido.

Incluye una captura en la que pueda comprobarse que el repositorio se ha inicializado correctamente.

3. Primer commit

Consulta el estado del repositorio e identifica los archivos que todavía no están siendo seguidos por Git.

Prepara todos los archivos de la documentación para incluirlos en el repositorio.

Vuelve a consultar el estado y observa los cambios producidos.

Crea el primer commit utilizando como mensaje:

Add initial documentation

Comprueba nuevamente el estado del repositorio.

Consulta también el historial de commits y verifica que aparece el commit que acabas de crear.

Documenta el proceso realizado.

4. Registrar cambios

Abre el archivo principal:

docs/index.md

y realiza una pequeña modificación en su contenido.

Guarda los cambios.

Desde la terminal:

1. Comprueba el estado del repositorio.
2. Consulta las diferencias respecto al último commit.
3. Prepara el archivo modificado.
4. Crea un nuevo commit.
5. Consulta nuevamente el historial.

Utiliza un mensaje de commit que describa brevemente el cambio realizado.

Mensajes de commit

Un mensaje de commit debe permitir identificar el cambio realizado.

Por ejemplo:

Update main documentation

Evita mensajes poco descriptivos como:

cambios
cosas
prueba
commit

Incluye una captura en la que pueda observarse el historial con los commits realizados.

Documentación de la actividad

Documenta todo el proceso realizado en el archivo correspondiente a esta actividad.

Incluye:

• Los comandos utilizados.
• Una breve explicación de las operaciones realizadas.
• Capturas de pantalla que permitan comprobar el proceso.
• Los errores encontrados y cómo los has solucionado, cuando corresponda.

Capturas de pantalla

Cuando trabajes desde la terminal, las capturas deben permitir ver tanto el comando ejecutado como su resultado.

No es necesario realizar una captura para cada comando. Agrupa varios pasos relacionados cuando sea posible.

Referencias

Añade las fuentes utilizadas para realizar la actividad.

Utiliza preferentemente la documentación oficial:

• Git documentation.