Merge pull request 'fix(docs-portal): corregir anchor roto en playbook de crashloop de Medusa' (#17) from fix/docs-portal-anchor-roto into main

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'.

workloads/docs-portal/Dockerfile

@@ -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
 

workloads/docs-portal/docs/index.md

@@ -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.

workloads/docs-portal/docs/playbooks/incidente-crashloop-medusa.md

@@ -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