Declaraciones De Accesibilidad Tienen Un Lugar En GitHub

GitHub ha dado un paso significativo hacia la mejora de la accesibilidad dentro de los proyectos de software al facilitar el acceso a la información sobre accesibilidad mediante la implementación del archivo ACCESSIBILITY.md. Este archivo, visible en las páginas de resumen de los repositorios, ofrece un lugar estable para describir los objetivos de accesibilidad de un proyecto, las expectativas para los contribuyentes, los entornos soportados, las limitaciones conocidas y el proceso para reportar barreras.

Esta nueva función de GitHub viene a raíz de la observación de que el trabajo en accesibilidad a menudo se dispersa en rastreadores de problemas, guías de contribución, informes de auditoría, conocimientos de equipo y conversaciones con usuarios. Sin un lugar predecible para esta información, aquellos que encuentran una barrera deben buscarla, y los encargados de mantenimiento pierden contexto a medida que los contribuyentes y la propiedad del proyecto cambian.

GitHub ahora reconoce el archivo ACCESSIBILITY.md en la raíz del repositorio, en el directorio .github/ o en el directorio docs/. Además, un repositorio puede heredar una declaración de accesibilidad del repositorio .github/ de su organización. Para los repositorios públicos, los encargados de mantenimiento pueden agregar o proponer una declaración desde la sección <strong>Insights</strong> > <strong>Community Standards</strong> utilizando un documento inicial conciso.

La inclusión del archivo ACCESSIBILITY.md dentro de los estándares de la comunidad de GitHub también está acompañada por una etiqueta de problema de accesibilidad que se agrega por defecto a los nuevos repositorios. Esta etiqueta ayuda a los mantenedores a organizar y rastrear el trabajo resultante derivado de los problemas de accesibilidad reportados.

A través de ejemplos como la declaración de accesibilidad del CLI de GitHub y del GitHub Annotation Toolkit, se ilustran prácticas útiles para documentar configuraciones, barreras conocidas, alternativas y expectativas claras de contribución. Estos documentos no solo proporcionan soluciones específicas para los desarrolladores y contribuyentes, sino que también establecen límites claros sobre lo que el proyecto ha verificado.

La implementación de un archivo ACCESSIBILITY.md tiene varios beneficios. Facilita la comunicación de prácticas del proyecto, establece expectativas claras para contribuyentes, y proporciona una vía accesible para reportar barreras. Al estandarizar esta práctica a lo largo de los proyectos de código abierto, se fomenta que la accesibilidad se integre como una parte fundamental en la planificación, construcción, reporte y mejora comunitaria del trabajo.

En resumen, el archivo ACCESSIBILITY.md es un recurso valioso para quienes llegan a un proyecto después de que algo ha salido mal. La simplicidad del lenguaje, la claridad de los enlaces descriptivos y una ruta de informe accesible son más importantes que el lenguaje legal o pesado en estándares. Este esfuerzo por normalizar declaraciones de accesibilidad en los proyectos abiertos es un movimiento crucial hacia la inclusión y la apertura en el desarrollo de software.

vía: Github Open Source

Scroll al inicio