home.md

-# Bienvenido a la wiki del proyecto "Cielito"
+# Bienvenido a la wiki del proyecto *Cielito*
 
 El objetivo de esta wiki es reemplazar a ese compañero o compañera que tarda en contestar tus mensajes cuando te surge una duda sobre los servicios en línea de la UdelaR en el Inteiror. 
 
 Luego del sitio [www.interior.edu.uy](https://www.interior.edu.uy/) de presentación de dichos servicios informáticos y de redes, brinda infomación más detalladas para el uso y configuración de los mismos.  
 
-## Documentación para personas usuarias finales
+## Tabla de contenidos
+- [Documentación para personas usuarias finales](#documentación-para-personas-usuarias-finales)
+  - [Instructivos de uso/configuración de servicios](#instructivos-de-usoconfiguración-de-servicios)
+- [Documentación para personas DevOps](#documentación-para-personas-devops)
+  - [Entorno de desarrollo y flujo de trabajo](#entorno-de-desarrollo-y-flujo-de-trabajo)
+  - [Protocolos y estándares que seguimos](#protocolos-y-estándares-que-seguimos)
+  - [Procedimientos ya automatizados](#procedimientos-ya-automatizados)
+- [Compelentos y anexos](#compelentos-y-anexos)
+  - [Especificaciones y tareas a más largo plazo](#especificaciones-y-tareas-a-más-largo-plazo)
+  - [Bitácoras y documentación de procedimientos realizados](#bitácoras-y-documentación-de-procedimientos-realizados)
+  - [Material de utilidad](#material-de-utilidad)
 
-### Instructivos de uso/configuración de servicios
+# Documentación para personas usuarias finales
+
+## Instructivos de uso/configuración de servicios
 
 - [Charla interior, servidor Jitsi](Charla-Interior)
 - [Gestor de Identidad PWM](Gestor-Identidad)
 - [Manual LDAP para Asistentes Informáticos](Ldap-Asistentes)
 - [Servicio wifi académico mundial Eduroam](Configuraciones-Eduroam)
-- Para informáticos en sedes de la UdelaR [Proveer servicio Eduroam](Configuracion-Eduroam-AP)
+- Para informáticos en sedes de la UdelaR: [Proveer servicio Eduroam](Configuracion-Eduroam-AP)
 - Acceso remoto a la Red Académica Uruguaya: [VPN a la RAU](Red-Privada-Virtual)
 
-## Documentación para personas DevOps
+# Documentación para personas DevOps
 
 Esta parte centraliza la documentación relacionada al montaje de la [nueva plataforma de servidores del interior](https://proyectos.interior.edu.uy/projects/servidores/wiki/Plataforma_de_servidores_del_Interior) y a la [automatización de su configuración](https://proyectos.interior.edu.uy/projects/cloudcomputing) a través de la [presente documentación](https://git.interior.edu.uy/cielito/adminsys) y de [este proyecto Ansible](https://git.interior.edu.uy/adminsys/config).
 
-### Entorno de desarrollo y flujo de trabajo:
+## Entorno de desarrollo y flujo de trabajo
 
 Tratamos de apegarnos en la medida de lo posible al [flujo de trabajo ágil propuesto por GitLab](https://about.gitlab.com/blog/2016/10/25/gitlab-workflow-an-overview/). Principalmente con el mantra ["Siempre empieza con un issue"](https://about.gitlab.com/blog/2016/03/03/start-with-an-issue/), salvo excepciones razonables como cambios simples y concretos o que ya exista un issue tratando el asunto que te ocupa.
 
@@ -34,14 +46,14 @@ Tratamos de apegarnos en la medida de lo posible al [flujo de trabajo ágil prop
 - [Ansible como herramienta de documentación](ansible-como-herramienta-de-documentación)
 - [Trabajo colaborativo sincrónico](herramientas-para-trabajo-colaborativo)
 
-### Protocolos y estándares que seguimos:
+## Protocolos y estándares que seguimos
 
 - [Puesta en producción de un servicio con Ansible](Puesta-en-producción-de-un-servicio-con-Ansible)
 - [Roles Ansible](https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html#role-directory-structure)
 - [Nomenclatura de versionado](https://semver.org/lang/es/) - [Sintaxis del versionado](https://git-scm.com/book/es/v2/Fundamentos-de-Git-Etiquetado)
 - [Documentación](Documentacion)
 
-### Procedimientos ya automatizados:
+## Procedimientos ya automatizados
 
 - [Aprovisionamiento de usuarios y grupos *unix*](aprovisionamiento-usuarios-y-grupos-unix)
 - [Creación de un nuevo contenedor LXC](Creacion-de-un-nuevo-contenedor-LXC) (**TO DO**)
@@ -55,16 +67,16 @@ Tratamos de apegarnos en la medida de lo posible al [flujo de trabajo ágil prop
 - [Agregar un host al servidor de respaldos](agregar-un-host-al-servidor-de-respaldos)
 - [Conceder / revocar credenciales de acceso a servidor OpenVPN](Conceder-revocar-credenciales-de-acceso-a-servidor-OpenVPN)
 
-## Compelentos y anexos
+# Compelentos y anexos
 
-### Especificaciones y tareas a más largo plazo
+## Especificaciones y tareas a más largo plazo
 
 * [Gestión DNS](Gestión DNS)
 * [Feria Modo UdelaR](Feria Modo UdelaR)
 * [Shibboleth SSO](Shibboleth SSO)
 
 
-### Bitácoras y documentación de procedimientos realizados:
+## Bitácoras y documentación de procedimientos realizados
 - [Plan y procedimiento de actualización y migración de GitLab CE desde una instalación `from source` a una `Omnibus`](actualizar-migrar-gitlab-from-source-a-omnibus).
 - [Agregar un nuevo servidor como nodo del cluster Proxmox](agregar-un-nuevo-servidor-como-nodo-del-cluster-Proxmox)
 - [Plan y procedimiento de actualización del cluster Proxmox 5.X a 6](plan-y-procedimiento-de-actualización-del-cluster-Proxmox-5.X-a-6)
@@ -72,7 +84,7 @@ Tratamos de apegarnos en la medida de lo posible al [flujo de trabajo ágil prop
 - [Migración del Owncloud 9.1 de nube.interior.edu.uy a un NextCloud 16](Migración-del-Owncloud-9.1-de-nube.interior.edu.uy-a-un-NextCloud-16)
 - [Migración de servidor OpenVPN desde Debian Stretch a Buster](Migración-de-servidor-OpenVPN-desde-Debian-Stretch-a-Buster)
 
-### Material de utilidad
+## Material de utilidad
 - Git
   - [Documentación oficial](https://git-scm.com/docs)
   - [Workflows con Git](https://www.santiagomr.com/git-workflows)