Skip to content

WCAG2ICT Task Force request to Update non-web-ict.md #1197

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

Draft
wants to merge 23 commits into
base: main
Choose a base branch
from

Conversation

ChrisLoiselle
Copy link

@ChrisLoiselle ChrisLoiselle commented Apr 7, 2025

Request to update https://www.w3.org/WAI/standards-guidelines/wcag/non-web-ict/ WCAG2ICT overview page with edits from WCAG2ICT's Explainer work

@netlify /standards-guidelines/wcag/non-web-ict/

Request to update https://www.w3.org/WAI/standards-guidelines/wcag/non-web-ict/ WCAG2ICT overview page with edits from WCAG2ICT's Explainer work
Copy link

netlify bot commented Apr 7, 2025

Deploy Preview for wai-website ready!

Name Link
🔨 Latest commit 66e61b8
🔍 Latest deploy log https://app.netlify.com/sites/wai-website/deploys/68078b2806d0e0000925998b
😎 Deploy Preview https://deploy-preview-1197--wai-website.netlify.app/standards-guidelines/wcag/non-web-ict/
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 53 (🔴 down 43 from production)
Accessibility: 100 (no change from production)
Best Practices: 92 (no change from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify site configuration.

@ChrisLoiselle ChrisLoiselle marked this pull request as draft April 7, 2025 16:18
@ChrisLoiselle
Copy link
Author

@maryjom @daniel-montalvo , I've made the request to edit this page per our WCAG2ICT work on the "Explainer" content we developed within the WCAG2ICT Task Force. Happy to edit further. I left this in draft in case either of you want to amend the PR prior to submitting it to WAI.

@daniel-montalvo
Copy link
Contributor

Yeah thanks for that @ChrisLoiselle good to have this in draft for now -- I do plan to take a look at this and may have some comments.

Copy link
Contributor

@bruce-usab bruce-usab left a comment

Choose a reason for hiding this comment

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

Nice job! Thanks for making this look so straightforward!

Copy link

@pday1 pday1 left a comment

Choose a reason for hiding this comment

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

Nice job Chris.
I made a few minor editorial suggestions, and also found a missing link to a Kenya standard which meant the square brackets were shown in the rich diff.

@ChrisLoiselle
Copy link
Author

@maryjom @pday1 I'm happy to commit the proposed / suggested edits that you presented here in your comments and review. Did you want me to go ahead with those or do you want to wait for the meeting to vote to do so?

@maryjom
Copy link
Contributor

maryjom commented Apr 10, 2025 via email

Copy link
Contributor

@bruce-usab bruce-usab left a comment

Choose a reason for hiding this comment

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

+1 to @maryjom edits. Also "this document" should probably be "WCAG2ICT" or "this Note".

@ChrisLoiselle
Copy link
Author

@maryjom @pday1 @daniel-montalvo I believe I caught all additional edit actions in my commit and have accepted your recommendations as mentioned here and in the meeting on 4/10/25.

<cite>Guidance on Applying WCAG 2 to Non-Web Information and Communications Technologies (WCAG2ICT)</cite> describes how the Web Content Accessibility Guidelines (WCAG) can be applied to non-web information and communications technologies (ICT), including documents and software. WCAG2ICT is the acronym used for the W3C Guidance on Applying WCAG 2 to Non-web Information and Communication Technology Group Note.

The WCAG2ICT Group Note provides:
* [Informative](https://www.w3.org/TR/WCAG22/#dfn-informative) **guidance** that is not [normative](https://www.w3.org/TR/WCAG22/#dfn-normative) and that does not set requirements.
Copy link
Contributor

Choose a reason for hiding this comment

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

Not sure if linking to WCAG's definition of normative and informative is a good idea. We should think about how much we want to link to other places. This is a potential distraction for readers. Aren't normative and informative self-explanatory in this context?

Suggested change
* [Informative](https://www.w3.org/TR/WCAG22/#dfn-informative) **guidance** that is not [normative](https://www.w3.org/TR/WCAG22/#dfn-normative) and that does not set requirements.
* **Informative guidance** that is not normative and that does not set requirements.

Copy link
Contributor

Choose a reason for hiding this comment

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

I think this was something that the link was in the WCAG2ICT Note and when I copied in the text, and the link remained. However, there are those of us that work in the standards world and we know what normative vs. informative is. Not sure policy makers and others who are new to reading standards know the distinction. I don't think having a link is harmful here, and would prefer it be kept..

Copy link
Author

Choose a reason for hiding this comment

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

Task Force discussed, we want to keep these links. Closed without action.

Copy link
Contributor

Choose a reason for hiding this comment

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

@ChrisLoiselle

Thanks. I understand TF rationale. I'd like to leave this open in case this serves as guidance for other WAI Staff that will review this.

* Accessibility [standards organizations](https://en.wikipedia.org/wiki/Standards_organization) - to provide non-web language in the success criteria and definitions and to provide interpretation notes to help the organization make any potential adjustments or notes needed for specific technologies, if needed.
* ICT managers - who are familiar with WCAG to quickly get an overview of using WCAG as an accessibility benchmark for non-web ICT.
* Technology developers - to provide the language substitutions for non-web language in WCAG success criteria where existing accessibility standards don’t contain an interpretation.
* Policy makers (which includes legislators, regulators) - to inform policy makers how the WCAG2ICT note is being used to influence standards requirements where WCAG is being applied to non-web ICT.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
* Policy makers (which includes legislators, regulators) - to inform policy makers how the WCAG2ICT note is being used to influence standards requirements where WCAG is being applied to non-web ICT.
* Legislators and/or regulators) - to inform them how the WCAG2ICT note is being used to influence standards requirements where WCAG is being applied to non-web ICT.

Copy link
Author

Choose a reason for hiding this comment

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

  1. Partial accept - Task force suggested Policy makers (including regulators when making regulations). See Mary Jo's suggestion.

* older version: [Guidance on Applying WCAG 2.0 to Non-Web Information and Communications Technologies (WCAG2ICT)](https://www.w3.org/TR/wcag2ict-20/) was published 5 September 2013 and covers WCAG 2.0
* The URI [https://www.w3.org/TR/wcag2ict/](https://www.w3.org/TR/wcag2ict/) points to the latest completed version

## Who WCAG2ICT is for {#for}

WCAG2ICT is for ICT managers, ICT developers, policy makers, and others wanting to understand how WCAG 2 can be applied to non-web documents and software.
The WCAG2ICT Group Note is for standards developers, ICT managers, ICT developers, policy makers, and any others wanting to understand how WCAG 2 can be applied to non-web documents and software.
* Accessibility [standards organizations](https://en.wikipedia.org/wiki/Standards_organization) - to provide non-web language in the success criteria and definitions and to provide interpretation notes to help the organization make any potential adjustments or notes needed for specific technologies, if needed.
Copy link
Contributor

Choose a reason for hiding this comment

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

Remove link to SDOs, not relevant in this context and phrase is self explanatory.

Suggested change
* Accessibility [standards organizations](https://en.wikipedia.org/wiki/Standards_organization) - to provide non-web language in the success criteria and definitions and to provide interpretation notes to help the organization make any potential adjustments or notes needed for specific technologies, if needed.
* Accessibility standards organizations - to provide non-Web language in the success criteria and definitions and to provide interpretation notes to help the organization make any potential adjustments or notes needed for specific technologies, if needed.

Copy link
Author

Choose a reason for hiding this comment

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

  1. Accept - Remove link reference on standards org.
  2. Not accept - We will not change non-web to non-Web per priors on the same subject decision.

Copy link
Author

Choose a reason for hiding this comment

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

See Mary Jo's edit below.

WCAG2ICT is developed by the [WCAG2ICT Task Force](https://www.w3.org/WAI/GL/WCAG2ICT-TF/), provided for public review, and approved by the Accessibility Guidelines Working Group ([AG WG](https://www.w3.org/WAI/GL/)), which is part of the World Wide Web Consortium ([W3C](https://www.w3.org/)) Web Accessibility Initiative ([WAI](https://www.w3.org/WAI/)).
The WCAG2ICT Group Note is developed by a [Task Force (TF)](https://www.w3.org/WAI/about/groups/task-forces/wcag2ict/) of the [Accessibility Guidelines Working Group (AG WG)](https://www.w3.org/WAI/about/groups/agwg/). The [work statement](https://www.w3.org/WAI/about/groups/task-forces/wcag2ict/work-statement/) defines the objectives, scope, and approach for the WCAG2ICT Group Note. The participants of the WCAG2ICT TF are volunteers drawn from [W3C member organizations](https://www.w3.org/membership/list/) and [invited experts](https://www.w3.org/invited-experts/) and are supported by [Web Accessibility Initiative (WAI)](https://www.w3.org/WAI/about/#wai-staff).

### Related Documents
Copy link
Contributor

Choose a reason for hiding this comment

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

Traditionally, we have avoided having all these pointers to external resources on the overview pages. I think these belong more on the Note itself. I presume this is one thing that other WAI Staff may have comments on. Would we be OK moving these to the document itself (some of them are already there) and pointing to that section if we want to explicitly call them out in here.

@ChrisLoiselle
Copy link
Author

@pday1 @maryjom @daniel-montalvo I've made some of the suggested edits by @daniel-montalvo . I feel that others need conversation from task force due to aspects of suggestions on what was already agreed on in the Google doc explainer. We can talk to this on the call on Thursday.

@ChrisLoiselle
Copy link
Author

@daniel-montalvo @maryjom @pday1 I've incorporated some, not all of the Daniel and Mary Jo edits from past couple of days. We can explore the rest on the call if need be.

Copy link
Contributor

@bruce-usab bruce-usab left a comment

Choose a reason for hiding this comment

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

I am more than content with current draft which I reviewed. Thanks everyone!

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

Successfully merging this pull request may close these issues.

5 participants