feat(A11y): Add inclusive design principles
What does this MR do?
I've created this MR to start a conversation. I know this current proposal is not right, but I'm confident together we can create something better. My end hope is 'accessibility' is defined and available, and the definition helps us design a GitLab that allows everyone to contribute.
All of the content is lifted from @jeldergl 's fantastic Inputs and outputs presentation TODO: add video link when available.
Note: it looks like Definition Lists are not supported in our markdown. These can be changed to something more suitable if we don't intend to support them.
Problem
As a designer I want to know what our definition of accessibility is, and principles I can use to design GitLab to be accessible.
Does this MR meet the acceptance criteria?
-
The MR title and commit message meet the Pajamas commit conventions -
Add a description to this MR explaining the reasons for the proposed change, per say-why-not-just-what -
Include MR scope that reflects the purpose of the change in the description - For example, if this MR is focused on
usage guidelines
, addressingaccessibility challenges
could be added separately with a different MR
- For example, if this MR is focused on
-
If creating a new page on Pajamas from scratch, follow the page template structure -
Follow the Pajamas Voice & Tone Guidelines and GitLab Documentation Style Guide -
Link components to and from other related components and patterns on the .md
file, where helpful -
If embedding a Figma file, follow the Figma embed guide -
Assign it to a reviewer. All GitLab designers are reviewers, but you can also assign it directly to a maintainer or trainee maintainer -
Apply the correct component label(s) -
Select a milestone or due date
Edited by Jeremy Elder