La documentación oficial, ahora con buscador y en tu idioma

Con la 0.8.3, el sitio de documentación de DiagramaHub se ve como debe: navegación, buscador, modo oscuro y español e inglés. Además, la app queda sin textos sin traducir.

Si alguna vez entraste al sitio de documentación de DiagramaHub y viste Markdown crudo, sin menú ni buscador, no era tu navegador. GitHub Pages publicaba la carpeta docs/ con el tema por defecto de Jekyll, y la raíz del sitio respondía 404. La 0.8.3 lo corrige y aprovecha para pulir el idioma de la app.

Un sitio de documentación de verdad

La documentación vive en diagramahub.github.io/diagramahub y ahora se construye con MkDocs Material. Lo que encuentras:

Guía de instalación para hospedar DiagramaHub en tu infraestructura con Docker Compose.
Notas de versión de cada release, desde la 0.1.0 hasta la actual.
Buscador con sugerencias y resaltado del término.
Navegación por pestañas, botón para volver arriba y enlaces anterior/siguiente.
Modo claro y oscuro, que sigue la preferencia de tu sistema.
Botón para copiar en cada bloque de código, útil para los comandos de instalación.

En español y en inglés, de verdad

El sitio tiene un selector de idioma que te lleva a la misma sección en el otro idioma. Había un detalle: Material solo permite un idioma de interfaz para todo el sitio, así que las páginas en inglés mostraban el buscador y el índice en español. Se resolvió con un ajuste del tema por carpeta, y ahora cada página usa la interfaz de su idioma.

flowchart LR
    A[Push o pull request] --> B[GitHub Actions]
    B --> C{"mkdocs build --strict"}
    C -->|Enlace roto| D[La build falla, no se publica]
    C -->|Todo bien| E[GitHub Pages]
    E --> F["/es/ y /en/"]

Además, la build corre en modo estricto en cada push y pull request: si un enlace está roto, la build falla en lugar de publicar una página rota.

La app, sin textos sueltos

La 0.8.3 también revisó la interfaz del editor. Unos 40 textos —tooltips, placeholders, etiquetas para lectores de pantalla y textos alternativos de imágenes— estaban escritos directamente en los componentes, así que con la interfaz en inglés aparecían tooltips en español (y al revés). Ahora todos pasan por las traducciones, y una prueba automática verifica que español e inglés tengan las mismas claves.

Otros dos detalles:

Botones de solo icono accesibles. Zoom, tamaño de texto, pantalla completa y cerrar ahora tienen aria-label, así que un lector de pantalla los anuncia por su nombre.
Metadatos que siguen tu idioma. El atributo lang de la página, el título de la pestaña y la descripción cambian con el idioma activo. Antes la página se declaraba en inglés aunque la interfaz por defecto es español.

Si lo hospedas tú

La 0.8.3 no trae migraciones ni funciones nuevas. Reconstruye las imágenes como siempre:

docker compose up -d --build

Si mantienes un fork con su propio sitio de documentación, en GitHub Pages cambia la fuente de «Deploy from a branch» a «GitHub Actions».

Siguiente paso

Explora la documentación, instala DiagramaHub siguiendo la guía de instalación o pruébalo sin instalar nada en DiagramaHub Cloud. ¿Encontraste algo que falta en la documentación? Abre un issue en el repositorio.