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

WCAG2ICT Project: Make some global changes #18

Closed
13 of 14 tasks
maryjom opened this issue Oct 25, 2022 · 10 comments
Closed
13 of 14 tasks

WCAG2ICT Project: Make some global changes #18

maryjom opened this issue Oct 25, 2022 · 10 comments
Assignees

Comments

@maryjom
Copy link
Contributor

maryjom commented Oct 25, 2022

Status of this Document

  • Update the title of the document in this section and in the other places it appears in the document.
  • Update WCAG 2.0 links throughout to point to WCAG 2.2 latest published version.
  • Update WCAG 2.0 SC links throughout to point to corresponding WCAG 2.2 SC.
  • Update the Guideline links throughout to point to the corresponding WCAG 2.2 Guideline.
  • Update Understanding links to the WCAG 2.2 versions
  • Update links to conformance requirements to the WCAG 2.2 document.
  • Update links to techniques to go to the WCAG 2.2 versions
  • Discover if there's a way to resolve dictionary issues in the document (that are not included because there is no interpretation to non-web ICT)
  • Clean up links - references to github.io in the link address
  • Clean up links (if switching back to HTML)
  • Test all links that they go to the right places.
  • Add in whatever Note markup we decide upon
  • Add in whatever inserted text markup we decide upon
  • Potentially switch back to HTML.
@maryjom maryjom added this to the Update supporting sections milestone Oct 26, 2022
@maryjom maryjom self-assigned this Oct 27, 2022
@maryjom maryjom mentioned this issue Oct 28, 2022
@maryjom
Copy link
Contributor Author

maryjom commented Oct 28, 2022

NOTE: Could not change the following links in the 1.4.3 Understanding content because neither WCAG 2.1 nor WCAG 2.2 have working reference links for these documents. Opened WCAG issue 2756 to document these missing links from the WCAG understanding documents.

NOTE: Opened a new WCAG2ICT issue to track the addition /change of these references.

@maryjom
Copy link
Contributor Author

maryjom commented Oct 31, 2022

Also having problems with some of the internal document definitions and the way the links work (or don't) when I try to move them to reference the github.io link address.

For example this code does not work:
<a class="wcag2ict_termref" href="https://w3c.github.io/wcag2ict/#wcag2ict-def_set-of-software-programs" title="WCAG2ICT Definition: set of software programs"><cite>set of software programs</cite></a>

While this code works:
<a href="https://w3c.github.io/wcag2ict/#set-of-software-programs">set of software programs</a>
and
<a class="wcag2ict_termref" href="https://w3c.github.io/wcag2ict/#wcag2ict-def_software" title="WCAG2ICT Definition: software programs"><cite>software programs</cite></a>

Same goes with references to "set of documents" using the cite tags.
<a class="wcag2ict_termref" href="https://w3c.github.io/wcag2ict/#wcag2ict-def_set-of-documents" title="WCAG2ICT Definition: set of non-web documents"><cite>set of non-web documents</cite></a>

where the following format works, but doesn't use the cite code:
<a href="https://w3c.github.io/wcag2ict/#set-of-documents">set of documents</a>

@maryjom
Copy link
Contributor Author

maryjom commented Oct 31, 2022

Need to find out how to properly add WCAG 2.2 documents as citable references. Only WCAG 2.0 [WCAG20] shows up in the list of references. Need to be able to use the following 3 citations in the code:
[<cite><a href="https://w3c.github.io/wcag2ict/#REF-WCAG22">WCAG22</a></cite>]
[<cite><a href="https://w3c.github.io/wcag2ict/#REF-UNDERSTANDING-WCAG22">UNDERSTANDING-WCAG22</a></cite>]
[<cite><a href="https://www.github.io/wcag2ict/#REF-WCAG22-TECHS">WCAG22-TECHS</a></cite>]

NOTE: This was moved to a new issue.

@maryjom
Copy link
Contributor Author

maryjom commented Oct 31, 2022

Found out that there are two definitions of "content" in two different sections of the document. There are many references to each of them. Should this be consolidated into a single definition? Here are the two links:
<a href="https://w3c.github.io/wcag2ict/#content-on-and-off-the-web">Content</a>
<a href="https://w3c.github.io/wcag2ict/#content-web-content">Content</a>

Need to see if the first link is used only in SC and wcag2ict content references and the second is only used from the Understanding content.

@GreggVan
Copy link

GreggVan commented Oct 31, 2022 via email

@maryjom
Copy link
Contributor Author

maryjom commented Oct 31, 2022

Also having problems with some of the internal document definitions and the way the links work (or don't) when I try to move them to reference the github.io link address.

For example this code does not work: <a class="wcag2ict_termref" href="https://w3c.github.io/wcag2ict/#wcag2ict-def_set-of-software-programs" title="WCAG2ICT Definition: set of software programs"><cite>set of software programs</cite></a>

While this code works: <a href="https://w3c.github.io/wcag2ict/#set-of-software-programs">set of software programs</a> and <a class="wcag2ict_termref" href="https://w3c.github.io/wcag2ict/#wcag2ict-def_software" title="WCAG2ICT Definition: software programs"><cite>software programs</cite></a>

Same goes with references to "set of documents" using the cite tags. <a class="wcag2ict_termref" href="https://w3c.github.io/wcag2ict/#wcag2ict-def_set-of-documents" title="WCAG2ICT Definition: set of non-web documents"><cite>set of non-web documents</cite></a>

where the following format works, but doesn't use the cite code: <a href="https://w3c.github.io/wcag2ict/#set-of-documents">set of documents</a>

Found that these terms were missing the id="wcag2ict-def_set-of-software-programs" or id="wcag2ict-def_set-of-software-documents", so added those ids to the definitions.

@maryjom
Copy link
Contributor Author

maryjom commented Oct 31, 2022

If we look closely we will see that the second mention 7.3.7 content (Web content is only a placeholder to preserve the numbering — and points to the first one. So there is really only one. Is that a problem? gregg

------------------------------ Gregg Vanderheiden @.***
On Oct 31, 2022, at 9:21 AM, Mary Jo Mueller @.***> wrote: Found out that there are two definitions of "content" in two different sections of the document. There are many references to each of them. Should this be consolidated into a single definition? Here are the two links: Content</a](https://w3c.github.io/wcag2ict/#content-on-and-off-the-web%22>Content</a)> Content</a](https://w3c.github.io/wcag2ict/#content-web-content%22>Content</a)> Need to see if these first link is used only in SC and wcag2ict content references and the second is only used from the Understanding content. — Reply to this email directly, view it on GitHub <#18 (comment)>, or unsubscribe https://github.com/notifications/unsubscribe-auth/ACNGDXRAAWCNIQCPH7CR4CDWF7W2NANCNFSM6AAAAAARONR5LY. You are receiving this because you are subscribed to this thread.

@GreggVan The problem is that multiple definitions of the same term caused build errors, so one had to be commented out. However, not all of the link references to the terms were going to the right one (either through my introduced error, or something leftover) so I had to do another sweep of the document to catch them all. All of these comments on this issue are mainly to myself to make sure I address all of these things before calling this issue done.

@GreggVan
Copy link

GreggVan commented Nov 1, 2022 via email

@maryjom
Copy link
Contributor Author

maryjom commented Apr 11, 2023

Plan to use this issue to sweep the whole document for formatting and link changes, once we've got the includes, headings and document formatting settled.

@maryjom
Copy link
Contributor Author

maryjom commented Jun 14, 2023

I think these things are handled now. If something crops up, we can open a new issue.

@maryjom maryjom closed this as completed Jun 14, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Development

No branches or pull requests

2 participants