WCAG2ICT Project: Make some global changes

maryjom commented 1 year ago

Status of this Document

[x] Update the title of the document in this section and in the other places it appears in the document.
[x] Update WCAG 2.0 links throughout to point to WCAG 2.2 latest published version.
[x] Update WCAG 2.0 SC links throughout to point to corresponding WCAG 2.2 SC.
[x] Update the Guideline links throughout to point to the corresponding WCAG 2.2 Guideline.
[x] Update Understanding links to the WCAG 2.2 versions
[x] Update links to conformance requirements to the WCAG 2.2 document.
[x] Update links to techniques to go to the WCAG 2.2 versions
[x] 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)
[x] Clean up links - references to github.io in the link address
[x] Clean up links (if switching back to HTML)
[x] Test all links that they go to the right places.
[x] Add in whatever Note markup we decide upon
[x] Add in whatever inserted text markup we decide upon
[ ] Potentially switch back to HTML.

maryjom commented 1 year ago

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 commented 1 year ago

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 commented 1 year ago

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 commented 1 year ago

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 commented 1 year ago

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 Content

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 https://github.com/w3c/wcag2ict/issues/18#issuecomment-1297343503, or unsubscribe https://github.com/notifications/unsubscribe-auth/ACNGDXRAAWCNIQCPH7CR4CDWF7W2NANCNFSM6AAAAAARONR5LY. You are receiving this because you are subscribed to this thread.

maryjom commented 1 year ago

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 commented 1 year ago

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 commented 1 year ago

Got it

All set

gregg

——————————— Professor, University of Maryland, College Park Founder and Director Emeritus , Trace R&D Center, UMD Co-Founder Raising the Floor. http://raisingthefloor.org The Global Public Inclusive Infrastructure (GPII) http://GPII.net The Morphic project https://morphic.org

On Oct 31, 2022, at 12:07 PM, Mary Jo Mueller @.***> wrote:

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 … <x-msg://53/#> ------------------------------ 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 https://w3c.github.io/wcag2ict/#content-on-and-off-the-web%22%3EContent</a)> Content</a](https://w3c.github.io/wcag2ict/#content-web-content%22>Content https://w3c.github.io/wcag2ict/#content-web-content%22%3EContent</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) https://github.com/w3c/wcag2ict/issues/18#issuecomment-1297343503>, or unsubscribe https://github.com/notifications/unsubscribe-auth/ACNGDXRAAWCNIQCPH7CR4CDWF7W2NANCNFSM6AAAAAARONR5LY. You are receiving this because you are subscribed to this thread.

@GreggVan https://github.com/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.

— Reply to this email directly, view it on GitHub https://github.com/w3c/wcag2ict/issues/18#issuecomment-1297542497, or unsubscribe https://github.com/notifications/unsubscribe-auth/ACNGDXT6AEIW65Q6GRQLSD3WGAKFVANCNFSM6AAAAAARONR5LY. You are receiving this because you were mentioned.

maryjom commented 1 year ago

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 commented 1 year ago

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

w3c / wcag2ict

WCAG2ICT Project: Make some global changes #18

Status of this Document