workloads/docs-portal/Dockerfile

@@ -3,14 +3,6 @@ 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

@@ -44,12 +44,17 @@ que cada una pueda entrar por su propia puerta:
 
 ## Estado de este sitio
 
-Este portal se mantiene vivo junto con el lab — cada página muestra su
-última fecha de modificación real (`git-revision-date-localized`). 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.
+Este portal se mantiene vivo junto con el lab. La idea es que cada
+página muestre su última fecha de modificación real vía
+`git-revision-date-localized` — por ahora ese plugin está deshabilitado
+(ver TODO en `mkdocs.yml`): el build corre con `mkdocs build --strict`,
+que aborta ante cualquier `WARNING`, y el plugin no tiene historial git
+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
 `main` que toca `docs/` o `mkdocs.yml` dispara

workloads/docs-portal/mkdocs.yml

@@ -43,10 +43,18 @@ theme:
 plugins:
   - search:
       lang: es
-  - git-revision-date-localized:
-      enable_creation_date: true
-      type: date
-      fallback_to_build_date: true
+  # TODO (fase 2): git-revision-date-localized deshabilitado a propósito.
+  # El Dockerfile construye con context: workloads/docs-portal/, que no
+  # incluye .git (vive en la raíz del repo) — el plugin no tiene historial
+  # 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:
   - admonition

workloads/docs-portal/requirements.txt

@@ -1,3 +1,3 @@
 mkdocs==1.6.*
 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