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

Potentially unfamiliar terms/abbreviations in section 3 should be defined/explained. #15

Closed
jasonjgw opened this issue Nov 22, 2021 · 4 comments

Comments

@jasonjgw
Copy link
Contributor

Especially in section 3, there are numerous terms and occasional abbreviations introduced without definition or explanation.

Adding a glossary, or including brief explanations of terms that may not be familiar to members of the intended audience would contribute greatly to the readability of this document.

There are statements in section 3 that read like notes for internal use by its authors rather than as clear communications suitable for a wide audience. I can decode much of the language and abbreviations, but anyone not deeply embedded in accessibility work would probably find this much more difficult.

@Helixopp
Copy link
Contributor

Thank you for bringing this issue to our attention. We will review and edit accordingly.

@SheaBelsky
Copy link

+1 on this! One specific example I had to look up was ICT. It's used multiple times throughout the document, though it's first defined in Section 3, well after the first time it's been used.

First usage: https://w3c.github.io/wcag-maturity-model/index.html#about-w3c-accessibility-maturity-model

Defintion: https://w3c.github.io/wcag-maturity-model/index.html#ict-development-lifecycle

@Helixopp
Copy link
Contributor

Thank you, for bringing this to our attention. We will go through the document and clear up the definitions. It would be extremely helpful, if anyone can provide us with the specific instances that they think we need to address

@Helixopp
Copy link
Contributor

Glossary has been added as "Key Terms" and will continue to be refined during development. If any content is missing please identify in new issues.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants