Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

enhancement(content): a11y Objetivos de Aprendizaje #1214

Open
wants to merge 11 commits into
base: next
Choose a base branch
from

Conversation

unjust
Copy link
Member

@unjust unjust commented Aug 8, 2022

Addresses #1199

Hay que agregar Objetivos para accesibilidad (a11y) en nuestros proyectos. Estamos de acuerdo que falta eso en nuestro curriculum, pero el diablo esta en los detalles, por supuesto.

Despues conversar con el working group y con un experto de a11y en Globant, decidí sequir la estructura de WCAG por los objetivos para no reinventar la rueda y pensar tanto en nomenclatura etc. Un "pro" de eso es que WCAG han pensado mucho en una taxonomía y solo tenemos que copiarla. Un "con" es que los títulos o nombres a veces no son entendibles solo leyendolos y no mencionan codigo, y hay que ver un poco más de que se trata cada categoría o concepto.

En este PR puede encontrar 3 maneras para agrupar Objetivos.

1. 4 principios, 2 niveles (A, AA)
a11y tiene 4 principios: Perceivable, Operable, Understandable, Robust que agrupan pautas. Cada pauta tiene criterios que un sitio tiene que cumplir para alcanzar un nivel de cumplimento (Compliance) (A - básico, AA - acceptable, AAA)
Pros: corto y muy digerible, si WCAG agrega mas pautas no tenemos que cambiarlos.
Con: porque los principios son generales, hay que investigar de que se trata cada uno (lxs estudiantes y nosotros coaches).

2. 4 principios con las pautas
Los OAs consiste de los nombres de pautas dentro cada principio. Puedes ver eso por un ejemplo de como es.yml puede parecer
Pros: mas detalle del anterior, etiquetas/titulos mas descriptivas y transmitir mas la tema (mas recordable?).
Con: si WCAG agrega mas pautas tenemos que actualizarlos, aun hay que investigar un poco de que se trata cada categoria (lxs estudiantes y nosotros coaches).

3. 4 principios y sus criterios
Los OAs consiste de los nombres de criterios dentro cada pauta. Solo incluye criterios A y AA. Quiza no tenemos incluir todos A y AA, solo los criterios que tiene sentido para nuestro curriculum.
Pros: mas detalle del anterior, etiquetas/titulos mas descriptivas que transmiten mas su idea.
Con: demasiada larga la lista, pero podemos elegir algunas que nos sirven.

Me gustaria feedback de cual camino parece mejor, antes que hacer los es.yml y pt.yml en este misma PR.
Quiero que encontremos un balance de detalle en los OAs pero también algo que nos podamos guiar sin un montón de trabajo o experiencia. Toma en cuenta:

  • En los proyectos no vamos a incluir todos, solo los que aplican particularmente en el proyecto.
  • No esperemos tampoco que ellas van a lograr 100% de los OAs de a11y incluido en cada proyecto, como no hay la expectativa que logran 100% de OAs en general.
  • Si no somos expertos creo esta bien, la responsabilidad debe ser de ellas a mostrarnos en Project Feedbacks que han investigado y implementado x tecnica/practica en su codigo para lograrlo.

Update

@unjust unjust self-assigned this Aug 8, 2022
@unjust
Copy link
Member Author

unjust commented Aug 8, 2022

@merunga @lalogf @diegovelezg @lupomontero @OfeliaR, igual voy a compartir el link con mas coaches.

@unjust unjust added enhancement New feature or request help wanted Extra attention is needed content Relacionado al contenido de proyectos y tópicos labels Aug 9, 2022
@merunga
Copy link
Contributor

merunga commented Aug 9, 2022

Gracias @unjust !
Personalmente prefiero los OAs mas self explanatory, en lugar de A o AA, pero no entiendo muy bien cuál es la diferencia entre estos y estos otros... pero me inclino a algo parecido a esos 2

Comment on lines 78 to 96
# another form of grouping with principales and guidelines
# a11y:
# - perceivable:
# - text-alternatives
# - time-based-media
# - adaptable-content
# - distinguishable-content
# - operable:
# - keyboard-accessible
# - enough-time
# - seizures-physical-reactions
# - navigable
# - input-modalities
# - understandable:
# - readable
# - predictable
# - input-assistance
# - robust:
# - compatible
Copy link
Member Author

@unjust unjust Aug 9, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@merunga este ☝️ contiene los principios y sus pautas (guidelines) que estan dentro cada principio. En la taxonomia WCAG, cada principio tiene pautas, y cada pauta tiene criterios
https://coda.io/d/a11y-Bootcamp_dWuo7bpUXjF/OAs-de-Pautas_susBJ#_lunqw.

Estes si son mas descriptivos que solo los principios, pero igual espero que el es/pt.yml con titulos y recursos apoyarian bien que significa cada uno.

Aqui es algo parecido como un es.yml puede ser: https://coda.io/d/a11y-Bootcamp_dWuo7bpUXjF/OAs-de-Pautas_susBJ#_lunqw

# - robust:
# - compatible

# another form of grouping with principales and criteria
Copy link
Member Author

@unjust unjust Aug 9, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Y estes abajo 👇 contiene los principios y los criterios de nivel A y AA (ejemplo de criterio). Los criterios son más detalladas de que necesitas cumplir, pero tampoco puedes entender todo que implica solo de sus nombres.

Salte las cabezados de pautas porque creo principio/pauta/criterio es muy nido.
es mas clara @merunga?

@unjust
Copy link
Member Author

unjust commented Aug 12, 2022

@mfdebian me dijiste algunas opiniones ayer de la cantidad de OAs. Creo este version es un buen intermedio. Seria bueno agregar todos para mantener la estructura de WCAG, pero si tendría que priorizar/elegir algunos, seria estos con *. No creo estaria mal incluir todos porque vamos a elegir algunos para cada proyecto a los que pertenece.

# a11y:
# - perceivable:
#   - text-alternatives *
#   - time-based-media
#   - adaptable-content *
#   - distinguishable-content *
# - operable:
#   - keyboard-accessible *
#   - enough-time
#   - seizures-physical-reactions
#   - navigable *
#   - input-modalities
# - understandable:
#   - readable *
#   - predictable *
#   - input-assistance *
# - robust:
#   - compatible *

@unjust
Copy link
Member Author

unjust commented Aug 26, 2022

Encontre este pagina https://www.w3.org/WAI/fundamentals/accessibility-principles/es que tiene los 4 principios y contenido para describir cada pauta - y estoy inclinando mas a esta organizacion y nivel de granularidad.

@mfdebian
Copy link
Collaborator

mfdebian commented Sep 7, 2022

Sólo para confirmar que estoy al día, en lo que vamos hoy es lo que está en esta entrada de CODA, que refleja lo de la última reunión que tuvimos el viernes pasado, no? 😊

Me parece buenísimo!! 🥳 qué emoción! gracias @unjust por tu liderazgo en esto! 🙌

@unjust unjust changed the base branch from main to next July 10, 2023 19:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
content Relacionado al contenido de proyectos y tópicos enhancement New feature or request help wanted Extra attention is needed
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Agrega accesibilidad (a11y) objetivos a los objetivos de aprendizaje
3 participants