From 0234c20463dfa415fd5ea0f4d350639eb070f704 Mon Sep 17 00:00:00 2001 From: Cristian Felipe Cruz Buitron Date: Thu, 13 Aug 2026 22:27:56 -0500 Subject: [PATCH] fix(docs-portal): deshabilitar git-revision-date-localized (rompe --strict) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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. --- workloads/docs-portal/Dockerfile | 8 -------- workloads/docs-portal/docs/index.md | 17 +++++++++++------ workloads/docs-portal/mkdocs.yml | 16 ++++++++++++---- workloads/docs-portal/requirements.txt | 2 +- 4 files changed, 24 insertions(+), 19 deletions(-) diff --git a/workloads/docs-portal/Dockerfile b/workloads/docs-portal/Dockerfile index c2a4b7d..22bdd77 100644 --- a/workloads/docs-portal/Dockerfile +++ b/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 diff --git a/workloads/docs-portal/docs/index.md b/workloads/docs-portal/docs/index.md index 99ad957..06fe08d 100644 --- a/workloads/docs-portal/docs/index.md +++ b/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 diff --git a/workloads/docs-portal/mkdocs.yml b/workloads/docs-portal/mkdocs.yml index 15e64e5..b6e71fe 100644 --- a/workloads/docs-portal/mkdocs.yml +++ b/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 diff --git a/workloads/docs-portal/requirements.txt b/workloads/docs-portal/requirements.txt index 0f4e44e..617064a 100644 --- a/workloads/docs-portal/requirements.txt +++ b/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 -- 2.54.0