Adición de una página de accesibilidad al repositorio

Agregue un ACCESSIBILITY.md archivo para que la información de accesibilidad del proyecto sea fácil de encontrar y proporcionar a las personas una manera clara de notificar las barreras.

En este artículo

Cuando un repositorio contiene un ACCESSIBILITY.md archivo, GitHub muestra una pestaña Accesibilidad en la información general del repositorio y vínculos a la página desde la sección Acerca del repositorio.

GitHub busca el archivo en el .github directorio, la raíz del repositorio y el docs directorio, en ese orden. Si el repositorio no contiene una página de accesibilidad, puede heredar una de un repositorio denominado .github que es propiedad de la organización.

Una página de accesibilidad puede describir las prioridades de accesibilidad del proyecto, entornos admitidos, barreras conocidas, expectativas de colaborador, proceso de informes, propiedad y mantenimiento.

Adición de una página de accesibilidad desde Estándares de la comunidad

Para un repositorio público, puede empezar con la plantilla de página de accesibilidad.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. Debajo del nombre del repositorio, haz clic en Insights.

    Captura de pantalla de la página principal de un repositorio. En la barra de navegación horizontal, una pestaña, etiquetada con un icono de grafo e "Información", se destaca en naranja.

  3. En la barra lateral izquierda, haga clic en Estándares de la comunidad.

  4. En "Archivo de comunidad adicional", busque "Accesibilidad" y haga clic en Agregar o proponer.

  5. Reemplace las instrucciones de la plantilla por información relacionada con la accesibilidad del proyecto. Las instrucciones se almacenan en comentarios y no aparecen cuando GitHub representa el archivo.

  6. Haga clic en Confirmar cambios.

  7. En el campo de "Mensaje de confirmación", escriba un mensaje de confirmación corto y significativo que describa la modificación que hizo en el archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo. Para más información, consulta Creación de un commit con varios autores o en nombre de una organización.

  8. Debajo de los campos para el mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una nueva rama. Si tu rama actual es la rama predeterminada, debes elegir crear una nueva rama para tu confirmación y después crear una solicitud de extracción. Para más información, consulta Crear una solicitud de incorporación de cambios.

    Captura de pantalla de una solicitud de extracción de GitHub que muestra un botón de opción para hacer la confirmación directamente en la rama principal o para crear una nueva rama. Aparece seleccionada la opción de rama nueva.

  9. Haz clic en Confirmar cambios o Proponer cambios.

Creación de una página de accesibilidad manualmente

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. Encima de la lista de archivos, selecciona el menú desplegable Add file y después haz clic en Create new file.

    Como alternativa, puedes hacer clic en en la vista de árbol de archivos a la izquierda.

    Captura de pantalla de la página principal de un repositorio que resalta el icono "Agregar archivo" y el icono "signo más", descrito anteriormente, con un contorno naranja.

  3. En el campo nombre de archivo, escriba ACCESSIBILITY.md. Para almacenar el archivo en el .github directorio o docs , escriba .github/ACCESSIBILITY.md o docs/ACCESSIBILITY.md.

  4. En la pestaña Editar nuevo archivo , agregue información relacionada con la accesibilidad.

  5. Haga clic en Confirmar cambios.

  6. En el campo de "Mensaje de confirmación", escriba un mensaje de confirmación corto y significativo que describa la modificación que hizo en el archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo. Para más información, consulta Creación de un commit con varios autores o en nombre de una organización.

  7. Si tiene más de una dirección de correo electrónico asociada a su cuenta en , haga clic en GitHubel menú desplegable dirección de correo electrónico y seleccione la dirección de correo electrónico que se usará como dirección de correo electrónico del autor de Git. Únicamente las direcciones de correo electrónico verificadas aparecen en el menú desplegable. Si ha habilitado la privacidad de la dirección de correo electrónico, una dirección de correo electrónico de no respuesta será la dirección de correo electrónico predeterminada del autor del commit. Para más información sobre el formato exacto que puede tomar la dirección de correo electrónico sin respuesta, consulta Configurar tu dirección de correo electrónico de confirmación.

Captura de pantalla de una solicitud de cambios de GitHub en la que se muestra un menú desplegable con opciones para elegir la dirección de correo electrónico del creador de la confirmación. octocat@github.com está seleccionado.

  1. Debajo de los campos para el mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una nueva rama. Si tu rama actual es la rama predeterminada, debes elegir crear una nueva rama para tu confirmación y después crear una solicitud de extracción. Para más información, consulta Crear una solicitud de incorporación de cambios.

    Captura de pantalla de una solicitud de extracción de GitHub que muestra un botón de opción para hacer la confirmación directamente en la rama principal o para crear una nueva rama. Aparece seleccionada la opción de rama nueva.

  2. Haz clic en Confirmar cambios o Proponer cambios.