La accesibilidad empieza en la fuente
Un tema puede aportar buen contraste y navegación por teclado, pero los autores deciden si el contenido es comprensible. Una jerarquía de headings incorrecta, enlaces sin sentido o screenshots sin alternativa no se reparan con CSS.
La accesibilidad debe estar en plantillas y revisión editorial.
Usa estructura semántica
Usa headings para jerarquía, listas como listas y tablas solo para relaciones realmente tabulares. Da a cada página un título descriptivo y un orden predecible.
Esto también mejora búsqueda, navegación y reuse.
Escribe enlaces comprensibles fuera de contexto
Evita “haz clic aquí”. El texto del enlace debe identificar destino o acción. No dependas solo del color para comunicar estado o significado.
Trata las imágenes como información
El alt text debe comunicar lo que el lector necesita obtener de la imagen, no describir cada píxel. Las imágenes decorativas pueden tener alt vacío. Un screenshot instructivo necesita texto cercano que exprese la acción esencial.
Para diagramas complejos, combina un alt breve con una explicación más larga cuando sea necesario.
Prueba patrones de autoría
Automatiza checks de alt, headings y enlaces vacíos, pero prueba páginas representativas con teclado y herramientas de accesibilidad. Incluye código, callouts, tabs y búsqueda.
La accesibilidad escala cuando los patrones seguros son los más fáciles de escribir.
Ejemplo aplicado
Aplica «WCAG 2.2 para equipos de documentación: por dónde empezar» a una página real. Elige contenido con encabezados, una tabla, una nota, un ejemplo, un término repetido y al menos una acción del lector. Revísalo primero como autor y luego como una persona que no conoce el vocabulario interno.
Registra defectos observables:
- qué estructura transmite significado que no existe en texto plano;
- qué término cambia de forma o significado;
- qué instrucción depende de contexto no explicado;
- qué regla sería difícil revisar de forma coherente.
Un estándar es útil cuando dos editores pueden llegar a decisiones parecidas sobre el mismo material. Si la regla suena bien pero no puede demostrarse en una página representativa, hay que precisarla, añadir un ejemplo o reducir su alcance.
Lista rápida de revisión editorial
- La accesibilidad empieza en la fuente. Un tema puede aportar buen contraste y navegación por teclado, pero los autores deciden si el contenido es comprensible.
- Usa estructura semántica. Usa headings para jerarquía, listas como listas y tablas solo para relaciones realmente tabulares.
- Escribe enlaces comprensibles fuera de contexto. Evita “haz clic aquí”.
- Trata las imágenes como información. El alt text debe comunicar lo que el lector necesita obtener de la imagen, no describir cada píxel.
