Compare commits

..
Author SHA1 Message Date
devops 0234c20463 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.
2026-08-13 22:27:56 -05:00
devops 9ec40370bf Merge pull request 'fix(docs-portal): corregir anchor roto en playbook de crashloop de Medusa' (#17) from fix/docs-portal-anchor-roto into main
Build and Push Docs Portal / Construir y publicar Docs Portal (push) Failing after 2m11s
2026-08-14 03:20:51 +00:00
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
# 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
+11 -6
View File
@@ -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
+12 -4
View File
@@ -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
+1 -1
View File
@@ -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