fix(docs-portal): deshabilitar git-revision-date-localized (rompe --strict)

mkdocs build --strict aborta ante CUALQUIER WARNING, no solo ante links
rotos. El plugin, al no tener .git real en el contexto de build
(workloads/docs-portal/, sin .git de la raíz del repo), cae siempre en
fallback_to_build_date y emite un WARNING por página — suficiente para
tumbar el build bajo --strict (confirmado en run 96, job 108: 33
warnings, todos de este plugin, cero links rotos).

Se deshabilita el plugin (comentado en mkdocs.yml y requirements.txt,
con TODO fase 2: mover el build a la raíz del repo + fetch-depth:0 para
darle historial real) y se revierte la instalación de git en el
Dockerfile, que ya no hace falta. index.md actualizado para no prometer
fechas reales que hoy no se muestran.
This commit is contained in:
2026-08-13 22:27:56 -05:00
parent 9ec40370bf
commit 0234c20463
4 changed files with 24 additions and 19 deletions
-8
View File
@@ -3,14 +3,6 @@ FROM python:3.12-slim AS build
WORKDIR /site 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 . COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt RUN pip install --no-cache-dir -r requirements.txt
+11 -6
View File
@@ -44,12 +44,17 @@ 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 — cada página muestra su Este portal se mantiene vivo junto con el lab. La idea es que cada
última fecha de modificación real (`git-revision-date-localized`). Si página muestre su última fecha de modificación real vía
una página dice "TODO", es contenido pendiente de una fase posterior, `git-revision-date-localized` — por ahora ese plugin está deshabilitado
no una promesa incumplida: la estructura completa se construyó primero (ver TODO en `mkdocs.yml`): el build corre con `mkdocs build --strict`,
a propósito, para que el contenido se llene sección por sección con el que aborta ante cualquier `WARNING`, y el plugin no tiene historial git
mismo criterio que el resto del lab. real que leer desde el contexto de build actual, así que se queda fuera
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 Desde este commit, el sitio se construye y publica solo: cada push a
`main` que toca `docs/` o `mkdocs.yml` dispara `main` que toca `docs/` o `mkdocs.yml` dispara
+12 -4
View File
@@ -43,10 +43,18 @@ theme:
plugins: plugins:
- search: - search:
lang: es lang: es
- git-revision-date-localized: # TODO (fase 2): git-revision-date-localized deshabilitado a propósito.
enable_creation_date: true # El Dockerfile construye con context: workloads/docs-portal/, que no
type: date # incluye .git (vive en la raíz del repo) — el plugin no tiene historial
fallback_to_build_date: true # real que leer y cae siempre en fallback_to_build_date, emitiendo un
# 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.* # mkdocs-git-revision-date-localized-plugin==1.2.* # deshabilitado, ver TODO en mkdocs.yml