-
Notifications
You must be signed in to change notification settings - Fork 7
2.4.2 Page Titled - Not all non-web docs and SW have titles that describe the topic or purpose #793
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
base: main
Are you sure you want to change the base?
Conversation
This is a reimplementation of PR #633 using the current main branch as the original source which was approved by the TF back in May but not incorporated because we hadn't solved non-web documents yet. This new PR is to address issue #627 - for both non-web documents and software since there are problems applying this SC in both cases.
✅ Deploy Preview for wcag2ict ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
###### Applying SC 2.4.2 Page Titled to Non-Web Documents | ||
|
||
This applies directly as written, and as described in [Intent from Understanding Success Criterion 2.4.2](https://www.w3.org/WAI/WCAG22/Understanding/page-titled#intent) replacing “web pages” with “non-web documents or software”. | ||
This success criterion is problematic to apply directly to non-web documents through simple word substitution because not all document formats provide support for a title attribute, and document titles don't always describe the topic or purpose of the document. File names, as the WCAG 2.2 Understanding document allows, also rarely describe the topic or purpose of the document – especially where the document names are not under the author’s control. However, where the document authoring tool or technology provides the capability to supply a semantic title style or name for a document, when the non-web document utilizes that feature to provide a unique title or name inside of each document, and/or when a meaningful file name can be supplied, the user can more easily find it or understand its purpose. This would address the user needs identified in the WCAG 2.2 Intent from Understanding Success Criterion 2.4.2. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Further edits to my original proposal based on 9 Oct minutes.
This success criterion is problematic to apply directly to non-web documents through simple word substitution because not all document formats provide support for a title attribute, and document titles don't always describe the topic or purpose of the document. File names, as the WCAG 2.2 Understanding document allows, also rarely describe the topic or purpose of the document – especially where the document names are not under the author’s control. However, where the document authoring tool or technology provides the capability to supply a semantic title style or name for a document, when the non-web document utilizes that feature to provide a unique title or name inside of each document, and/or when a meaningful file name can be supplied, the user can more easily find it or understand its purpose. This would address the user needs identified in the WCAG 2.2 Intent from Understanding Success Criterion 2.4.2. | |
This success criterion is problematic to apply directly to non-web documents through simple word substitution because not all document formats provide support for a semantic title style, and document titles don't always describe the topic or purpose of the document. File names, as the WCAG 2.2 Understanding document allows, also rarely describe the topic or purpose of the document – especially where the document names are not under the author’s control. However, where the document authoring tool or technology provides the capability to supply a semantic title style or name for a document, when the non-web document utilizes that feature to provide a unique title or name inside of each document, and/or when a meaningful file name can be supplied, the user can more easily find it or understand its purpose. This would address the user needs identified in the WCAG 2.2 Intent from Understanding Success Criterion 2.4.2. The following criterion is recommended as a substitute for the WCAG language: | |
**2.4.2 Non-web Document Titled:** In non-web documents created using an authoring tool that supports semantic title styles for documents, titles are provided that describe the topic or purpose of the non-web document. |
- "title attribute" may be easily confused with the functionality provided by the HTML title attribute, which is not the same as the title element. I suggest "semantic title" or "semantic title style" as you have later
- The Understanding documents don't "allow", they may "specify" or "explain" or similar, but "allow" is beyond what Understanding documents do.
- We are missing a word substitution alternative for this, similarly to what we have for non-web software.
- To address Gregg's concerns, I am restricting the alternative language to "created using an authoring tool that supports semantic title styles for documents".
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
see my suggestions
above
Gregg, Mike, and I had an email thread to develop potential language. The alternate requirement isn't exactly as Gregg had it but the note is what was proposed. I'm trying to keep this more closely aligned to WCAG2ICT's writing style which doesn't use the precondition style used in the EN 301 549.
This is a reimplementation of PR #633 using the current main branch as the original source which was approved by the TF back in May but not incorporated because we hadn't solved non-web documents yet. This new PR is to address issue #627 - for both non-web documents and software since there are problems applying this SC in both cases.