Saltar a contenido

GatewayQR - Municipalidad de Villa Allende

Portal de documentación. Cada página se genera a partir del Markdown que se mantiene en el repositorio. Los documentos técnicos (especificación, runbook, ADR, riesgos) están escritos en inglés; la hoja para la caja está en español.

Cómo ver el sitio localmente

Desde la raíz del repositorio (donde está mkdocs.yml), en un entorno virtual:

python -m venv .venv-docs

Actívelo (.venv-docs\Scripts\activate en Windows, source .venv-docs/bin/activate en Linux o macOS) y luego:

python -m pip install -r docs/requirements-docs.txt
mkdocs serve

mkdocs build --strict tiene que pasar antes de cada merge (lo corre la CI). Los archivos crudos de evidencia (logs, JSON, texto) y los PDF quedan en el repositorio, pero no se incluyen en el sitio generado.