Control de Versiones, Documentación y Organización — Avanzado

🎯 Objetivo del curso

Aprender a gestionar el código, la información y el conocimiento. Herramientas indispensables para trabajo colaborativo, respaldo, trazabilidad y mantenimiento de sistemas.

📌 Programa Sintético

Sistema Git: instalación, configuración, ciclo de vida. Operaciones básicas: commit, rama, fusión, etiquetas. GitHub: repositorios remotos, accesos, problemas y solicitudes. Flujos de trabajo: GitFlow, estrategias de equipo. Documentación técnica. Obsidian: organización personal y colectiva. Gestión de activos digitales. Proyecto final: repositorio documentado y base de conocimiento.

🧩 Proyecto del nivel

Repositorio GitHub profesional de un proyecto AIoT: código versionado, README completo, documentación técnica estructurada y base de conocimiento en Obsidian vinculada al repo.

Unidad 1 (Sem 1-2): Git y operaciones básicas. Unidad 2 (Sem 3-4): GitHub y flujos de trabajo. Unidad 3 (Sem 5-6): Documentación y Obsidian. Unidad 4 (Sem 7-8): Activos digitales y proyecto final.

Unidad 1 — Git Internals y Técnicas Avanzadas (Sem 1-2)

• Objetos Git, reflog, rebase interactivo
• Submódulos y subtrees
• Lab: reorganización de repositorio legacy

Unidad 2 — GitHub Actions y Automatización (Sem 3-4)

• Workflows: triggers, jobs, steps
• Actions del marketplace y acciones propias
• Lab: pipeline completo para proyecto IoT

Unidad 3 — Gestión de Repositorios a Escala (Sem 5-6)

• Monorepo vs multi-repo: criterios
• Organización GitHub: teams, permisos, CODEOWNERS
• Lab: estructura de organización GitHub para AIoT Academy

Unidad 4 — Obsidian Avanzado (Sem 7-8)

• Plugins esenciales: Dataview, Templater, Kanban
• Flujo de trabajo PKM (Personal Knowledge Management)
• Lab: sistema de gestión de conocimiento técnico completo

Unidad 5 — Documentación como Código (Sem 9-10)

• Docs-as-code: Markdown, MkDocs, Docusaurus
• Versionado de documentación junto al código
• Lab: sitio de documentación técnica desplegado automáticamente

Unidad 6 — Automatización de Documentación (Sem 11-12)

• Generación automática de API docs: Swagger, Doxygen
• Changelogs automáticos con Conventional Commits
• Lab: pipeline de documentación automática

Unidad 7 — Seguridad en el Repositorio (Sem 13-14)

• Secret scanning y Dependabot
• Firma de commits con GPG
• Lab: repositorio hardened con todas las medidas de seguridad

Unidad 8 — Proyecto Final (Sem 15-16)

• Repositorio organizacional completo: código, docs, CI/CD, seguridad
• Base de conocimiento institucional en Obsidian

Bienvenido a Control de Versiones — Nivel Avanzado.

Este nivel cubre estrategias de ramificación complejas, automatización con GitHub Actions y la organización de conocimiento a escala con Obsidian.

Semana 1:
– Git internals: cómo funciona Git por dentro
– Objetos Git: blob, tree, commit, tag
– git reflog: el historial oculto
– Estrategias avanzadas de branching en organizaciones