← Volver al Blog

Resolución de 404s Headless y Enlaces Ambiguos WAI-ARIA

Durante las auditorías de rendimiento continuo en producción, el rastreador local (merci-linkcheck.py) bloqueó el pipeline al detectar una doble vulnerabilidad funcional: enlaces de descarga que apuntaban a PDFs fantasma (404) y una infracción severa de accesibilidad (WAI-ARIA) provocada por la existencia de atributos idénticos en enlaces que apuntaban a artículos distintos con el mismo título.

En una arquitectura Headless, confiar ciegamente en que el CMS «generará por defecto» el archivo estático es un antipatrón de diseño.

Para resolver esta fricción, se tomó la decisión más sana a nivel arquitectónico: extirpar la funcionalidad. Se amputó la generación de PDFs dinámicos en el orquestador (merci-wp.py). El blog es un flujo rápido y efímero; no necesita la pesada carga de renderizar documentos offline. Si alguien quiere un PDF inmutable, acudirá a la Biblioteca estática.

Paralelamente, inyectar una dimensión temporal (la fecha) en los atributos WAI-ARIA erradicó por completo las colisiones para los lectores de pantalla sin alterar la interfaz visual en lo más mínimo.

💡 En resumen:

En lugar de intentar arreglar los botones de descarga rotos en las noticias del blog, nos dimos cuenta de que era una función innecesaria y los eliminamos completamente, haciendo la web más ligera y libre de errores.

Además, se ha añadido la fecha «invisible» a los nombres internos de los artículos para que las personas que usan lectores de pantalla no se confundan cuando haya dos textos distintos que se llamen igual.

Tienes disponible el cuadernillo técnico detallando el código y la arquitectura de esta maniobra en la estantería de DevSecOps: Resolución de 404s Headless y Enlaces Ambiguos WAI-ARIA.

↑