Compare commits

..
Author SHA1 Message Date
devops 376eb6d46a 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:09:56 -05:00
3 changed files with 11 additions and 32 deletions
+6 -19
View File
@@ -44,22 +44,9 @@ que cada una pueda entrar por su propia puerta:
## Estado de este sitio ## Estado de este sitio
Este portal se mantiene vivo junto con el lab. La idea es que cada Este portal se mantiene vivo junto con el lab — cada página muestra su
página muestre su última fecha de modificación real vía última fecha de modificación real (`git-revision-date-localized`). Si
`git-revision-date-localized` — por ahora ese plugin está deshabilitado una página dice "TODO", es contenido pendiente de una fase posterior,
(ver TODO en `mkdocs.yml`): el build corre con `mkdocs build --strict`, no una promesa incumplida: la estructura completa se construyó primero
que aborta ante cualquier `WARNING`, y el plugin no tiene historial git a propósito, para que el contenido se llene sección por sección con el
real que leer desde el contexto de build actual, así que se queda fuera mismo criterio que el resto del lab.
hasta que ese contexto incluya `.git` de verdad. Si 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.
+4 -12
View File
@@ -43,18 +43,10 @@ theme:
plugins: plugins:
- search: - search:
lang: es lang: es
# TODO (fase 2): git-revision-date-localized deshabilitado a propósito. - git-revision-date-localized:
# El Dockerfile construye con context: workloads/docs-portal/, que no enable_creation_date: true
# incluye .git (vive en la raíz del repo) — el plugin no tiene historial type: date
# real que leer y cae siempre en fallback_to_build_date, emitiendo un fallback_to_build_date: true
# WARNING por página. mkdocs build --strict aborta ante CUALQUIER
# WARNING, así que mientras no se le dé contexto de build con .git real
# (mover el build a la raíz del repo + fetch-depth:0 en el workflow),
# este plugin debe quedar fuera para no romper el pipeline.
# - git-revision-date-localized:
# enable_creation_date: true
# type: date
# fallback_to_build_date: true
markdown_extensions: markdown_extensions:
- admonition - admonition
+1 -1
View File
@@ -1,3 +1,3 @@
mkdocs==1.6.* mkdocs==1.6.*
mkdocs-material==9.5.* mkdocs-material==9.5.*
# mkdocs-git-revision-date-localized-plugin==1.2.* # deshabilitado, ver TODO en mkdocs.yml mkdocs-git-revision-date-localized-plugin==1.2.*