Compare commits
3
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
0234c20463 | ||
|
|
9ec40370bf | ||
|
|
22534d65f3 |
@@ -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
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -87,7 +87,7 @@ en `medusa.yaml`.
|
||||
estaban en el **mismo nodo** (`k3d-lab-cluster-server-0`).
|
||||
- **Descartada para este incidente puntual** (sin tráfico cross-node
|
||||
involucrado) — pero sigue siendo una condición latente real del
|
||||
cluster. Ver [nota de deuda técnica](#deuda-técnica-pendiente) abajo.
|
||||
cluster. Ver [nota de deuda técnica](#deuda-tecnica-pendiente) abajo.
|
||||
|
||||
## Causa raíz real
|
||||
|
||||
|
||||
@@ -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,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
|
||||
|
||||
Reference in New Issue
Block a user