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

Proposed updates to the WCAG2ICT work statement #942

Open
wants to merge 8 commits into
base: main
Choose a base branch
from

Conversation

maryjom
Copy link
Contributor

@maryjom maryjom commented Oct 31, 2024

Preview

This is to update the work statement for phase 2 work remaining.

This is to update the work statement for phase 2 work remaining.
Copy link

netlify bot commented Oct 31, 2024

Deploy Preview for wai-website ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 8ee5128
🔍 Latest deploy log https://app.netlify.com/sites/wai-website/deploys/67586565d6ffd80008b4a094
😎 Deploy Preview https://deploy-preview-942--wai-website.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 88 (🔴 down 8 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.

Copy link

@ChrisLoiselle ChrisLoiselle left a comment

Choose a reason for hiding this comment

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

Hi @maryjom I read through this and it reads well. I won't approve until we talk through it on the upcoming task force call.

@maryjom
Copy link
Contributor Author

maryjom commented Nov 1, 2024

Hi @maryjom I read through this and it reads well. I won't approve until we talk through it on the upcoming task force call.

@ChrisLoiselle This extra markup is handled by the W3C website rendering/processing as it was already in the file and then appears on the rendered page as the table of contents at the top of the page. I don't know how to get a view that is the rendered content in my branch.

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.

Delete line 55 (which is to say, do not add it work statement).

To scope of work, and bullet something like:

To the extent determined by TF, provided recommendations as to which success criteria are not applicable to a particular non-web technology

@bruce-usab
Copy link
Contributor

I am strongly of the opinion that work statement should/could be revised so as not to preclude guidance similar to:

2.4.1 Bypass Blocks: A mechanism is available to bypass blocks of content that are repeated in software.

See the [21 Nov. meeting minutes](https://www.w3.org/2024/11/21-wcag2ict-minutes.html) for details of what was discussed.
* Publish updated WCAG2ICT Note.

### Phase 2

The next phase of updates would include any other in-scope work, including Level AAA, that was not addressed in Phase 1. Details of the Phase 2 timeline will be developed outside of this document when more is known about the scope of work left to do.
The next phase of updates will include any other in-scope work, including:
* Addition of guidance for Level AAA success criteria. Details of the Phase 2 timeline are found outside of this document. See the [schedule and milestones](https://github.com/w3c/wcag2ict/wiki/Schedule-and-milestones) page in the GitHub WCAG2ICT Wiki.

Choose a reason for hiding this comment

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

@daniel-montalvo per last week's meeting notes, should this be changed to be further down the list of items in the list?

Copy link
Contributor

Choose a reason for hiding this comment

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

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.

Proposed update have addressed the concerns I raised previously, thank you very much!

* address challenges in [Open issues labeled WCAG2ICT](https://github.com/w3c/wcag2ict/issues?q=is%3Aissue+is%3Aopen+label%3Awcag2ict).
* clarification of challenges of applying particular WCAG 2.x success criteria to non-web ICT, including closed product software;
* address challenges in [Open issues labeled WCAG2ICT](https://github.com/w3c/wcag2ict/issues?q=is%3Aissue+is%3Aopen+label%3Awcag2ict); and
* provide an explainer that clarifies the usage of WCAG2ICT

Choose a reason for hiding this comment

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

+1 to this addition.

Within the explainer, I'd like to see a section "What WCAG2ICT does not do". (I'll bring this idea to our next call, where the explainer outline is on the agenda.) Without solving every problem, we give a clear description of the problems that WCAG2ICT did not solve — like techniques, or how it applies to specific platforms and kinds of content. This will make it easier for a parallel or future effort, such as a community group, to have a clear place to pick up and continue from where the Task Force left off.

Choose a reason for hiding this comment

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

A high-level explanation will be valuable, but after today's Task Force call I don't think "explainer" is the right word for it. Other W3C Explainers are value propositions of an ongoing effort, whose main audience is other W3C members. I'd rather make it an introduction for audiences beyond the W3C, like this ATAG overview or this explanation of standards harmonization.

We can decide later whether this introduction will become part of the existing WCAG2ICT Note or a separate document.

Suggested change
* provide an explainer that clarifies the usage of WCAG2ICT
* provide a concise, high-level overview or introduction to WCAG2ICT, explaining its purpose and how to use it

pages/about/groups/task-forces/wcag2ict/work-statement.md Outdated Show resolved Hide resolved
Comment on lines 49 to 52
* as needed, suggested changes to success criteria normative language to more clearly align with non-web software and document technologies; and
NOTE: This would not be suggested changes to change WCAG itself, but instead provide language more meaninful in non-web contexts. For example, provide alternative language in criteria that the WCAG normative language uses CSS pixels, to use language more appropriate for non-web technologies.
* how each of the WCAG 2.x Level AAA success criteria could apply to non-web technologies.

Choose a reason for hiding this comment

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

The "NOTE:" is currently on a separate line in markdown, but is run together in the rendered page.

I suggest moving it below. This suggestion also wordsmiths the note...

Suggested change
* as needed, suggested changes to success criteria normative language to more clearly align with non-web software and document technologies; and
NOTE: This would not be suggested changes to change WCAG itself, but instead provide language more meaninful in non-web contexts. For example, provide alternative language in criteria that the WCAG normative language uses CSS pixels, to use language more appropriate for non-web technologies.
* how each of the WCAG 2.x Level AAA success criteria could apply to non-web technologies.
* as needed, suggested changes to success criteria normative language to more clearly align with non-web software and document technologies; and
* how each of the WCAG 2.x Level AAA success criteria could apply to non-web technologies.
NOTE: "suggested changes to success criteria" would not be suggestions to change WCAG itself, but instead to provide language more meaningful in non-web contexts. For example, in criteria where the WCAG normative language uses CSS pixels, the Task Force could provide alternative language more appropriate for non-web technologies.

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

Successfully merging this pull request may close these issues.

6 participants