fix(docs-portal): corregir anchor roto en playbook de crashloop de Medusa

mkdocs build --strict (run 95, job 107) falló: el link a '#deuda-técnica-pendiente' no coincide con el anchor real que genera mkdocs, porque el slugify por defecto de Python-Markdown normaliza tildes (NFKD + strip de combining marks) antes de generar el id del heading. El heading '## Deuda técnica pendiente' genera 'deuda-tecnica-pendiente' (sin tilde), no 'deuda-técnica-pendiente'.
Merge pull request 'fix(docs-portal): instalar git en la imagen de build para mkdocs-git-revision-date-localized-plugin' (#16 ) from fix/docs-portal-dockerfile-git-binario into main
2026-08-13 22:10:36 -05:00 · 2026-08-14 02:57:10 +00:00 · 2026-08-13 21:56:11 -05:00 · 2026-08-14 02:42:04 +00:00 · 2026-08-13 21:41:50 -05:00
3 changed files with 17 additions and 1 deletions
@@ -3,6 +3,14 @@ FROM python:3.12-slim AS build

 WORKDIR /site

+# mkdocs-git-revision-date-localized-plugin depende de GitPython, que
+# necesita el binario git presente solo para poder importarse (si falta,
+# el import truena y rompe el build --strict, incluso con
+# fallback_to_build_date activado en mkdocs.yml).
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends git \
+    && rm -rf /var/lib/apt/lists/*
+
 COPY requirements.txt .
 RUN pip install --no-cache-dir -r requirements.txt

@@ -50,3 +50,11 @@ una página dice "TODO", es contenido pendiente de una fase posterior,
 no una promesa incumplida: la estructura completa se construyó primero
 a propósito, para que el contenido se llene sección por sección con el
 mismo criterio que el resto del lab.
+
+Desde este commit, el sitio se construye y publica solo: cada push a
+`main` que toca `docs/` o `mkdocs.yml` dispara
+`.gitea/workflows/deploy-docs.yaml`, que hace `mkdocs build --strict`,
+publica la imagen en el Registry de Gitea y Argo CD sincroniza el
+Deployment en el cluster (namespace `docs-portal`). Este párrafo es la
+prueba: si lo estás leyendo servido desde el pod real, el pipeline
+funcionó de punta a punta.
@@ -87,7 +87,7 @@ en `medusa.yaml`.
  estaban en el **mismo nodo** (`k3d-lab-cluster-server-0`).
 - **Descartada para este incidente puntual** (sin tráfico cross-node
  involucrado) — pero sigue siendo una condición latente real del
-  cluster. Ver [nota de deuda técnica](#deuda-técnica-pendiente) abajo.
+  cluster. Ver [nota de deuda técnica](#deuda-tecnica-pendiente) abajo.

 ## Causa raíz real
Author	SHA1	Message	Date
devops	22534d65f3	fix(docs-portal): corregir anchor roto en playbook de crashloop de Medusa mkdocs build --strict (run 95, job 107) falló: el link a '#deuda-técnica-pendiente' no coincide con el anchor real que genera mkdocs, porque el slugify por defecto de Python-Markdown normaliza tildes (NFKD + strip de combining marks) antes de generar el id del heading. El heading '## Deuda técnica pendiente' genera 'deuda-tecnica-pendiente' (sin tilde), no 'deuda-técnica-pendiente'.	2026-08-13 22:10:36 -05:00
devops	45924f9df2	Merge pull request 'fix(docs-portal): instalar git en la imagen de build para mkdocs-git-revision-date-localized-plugin' (#16 ) from fix/docs-portal-dockerfile-git-binario into main Build and Push Docs Portal / Construir y publicar Docs Portal (push) Failing after 9m50s Details	2026-08-14 02:57:10 +00:00
devops	bb1249fd58	fix(docs-portal): instalar git en la imagen de build para mkdocs-git-revision-date-localized-plugin El plugin depende de GitPython, que necesita el binario git para importarse (no solo para leer fechas) — sin él, mkdocs build --strict falla en el import del plugin antes de llegar al fallback_to_build_date configurado en mkdocs.yml. Detectado en el primer intento real de build en Gitea Actions (run 94, job 106).	2026-08-13 21:56:11 -05:00
devops	10556758b2	Merge pull request 'docs(docs-portal): documentar que el pipeline de build/deploy quedó operativo' (#15 ) from fix/docs-portal-estado-pipeline-vivo into main Build and Push Docs Portal / Construir y publicar Docs Portal (push) Failing after 7m46s Details	2026-08-14 02:42:04 +00:00
devops	e8712327a2	docs(docs-portal): documentar que el pipeline de build/deploy quedó operativo Dispara el primer build real del portal via .gitea/workflows/deploy-docs.yaml ahora que el Deployment, Service, Ingress y el secret de registry ya existen en el namespace docs-portal.	2026-08-13 21:41:50 -05:00