Skip to content

Conversation

@maryjom
Copy link
Contributor

@maryjom maryjom commented Oct 6, 2025

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.

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.
@netlify
Copy link

netlify bot commented Oct 6, 2025

Deploy Preview for wcag2ict ready!

Name Link
🔨 Latest commit c01129c
🔍 Latest deploy log https://app.netlify.com/projects/wcag2ict/deploys/6903a8ddf5380a0008ac8e02
😎 Deploy Preview https://deploy-preview-793--wcag2ict.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

Copy link
Contributor

@daniel-montalvo daniel-montalvo left a 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.
@daniel-montalvo
Copy link
Contributor

@maryjom Thanks for putting this together. Just a minor comment that I put in one of our Pevious discussions

The Understanding documents don't "allow", they may "specify" or "explain" or similar, but "allow" is beyond what Understanding documents do.

This is an editorial change that should not affect the CfC.
pday1
pday1 previously approved these changes Oct 29, 2025
@maryjom
Copy link
Contributor Author

maryjom commented Oct 29, 2025

@daniel-montalvo I cannot merge this until you re-review.

@daniel-montalvo
Copy link
Contributor

Hi @maryjom

When re-reviewing this for approval I still found an occurrence of "page-oriented", which I assumed we agreed to remove completely from all WCAG2ICT prose.

At a minimum, I would suggest:

However, where the document authoring tool or technology provides the capability to supply a title or name for a document, such as page-oriented publishing tools and word processing applications, when the non-web document utilizes the “Title” attribute to provide a unique title or name inside of each document, and/or when a meaningful file name can be supplied, [...]

And ideally, to make this cohesive with the below word substitution, I would suggest:

However, where the document authoring tool or technology provides the capability to supply a title or name for a document, such as page-oriented publishing tools and word processing applications, when the non-web document utilizes the “Title” attribute to provide a unique title or name inside of each document, and/or when a meaningful file name can be supplied, [...]

@maryjom
Copy link
Contributor Author

maryjom commented Oct 30, 2025

@daniel-montalvo I'll ask the group today what their understanding was. I think it was most important to remove from the suggested replacement requirement - which we did. The above sentence is only to provide some examples so page-oriented may still be OK in that context.

@daniel-montalvo
Copy link
Contributor

@daniel-montalvo I'll ask the group today what their understanding was. I think it was most important to remove from the suggested replacement requirement - which we did. The above sentence is only to provide some examples so page-oriented may still be OK in that context.

+1 for double checking with the group about this.

bruce-usab
bruce-usab previously approved these changes Oct 30, 2025
Co-authored-by: Daniel Montalvo <49305434+daniel-montalvo@users.noreply.github.com>
@maryjom maryjom dismissed stale reviews from bruce-usab and pday1 via 2dc00e1 October 30, 2025 15:01
@maryjom
Copy link
Contributor Author

maryjom commented Oct 30, 2025

@daniel-montalvo I've incorporated your changes to this PR, please re-review so I can merge. Thanks!

@maryjom maryjom self-assigned this Oct 30, 2025
@maryjom
Copy link
Contributor Author

maryjom commented Oct 30, 2025

@daniel-montalvo Don't forget to review this PR for 2.4.2 Page Titled.

@maryjom maryjom closed this Oct 30, 2025
@maryjom maryjom reopened this Oct 30, 2025
<div class="note wcag2ict software">
See also the [Comments on Closed Functionality](#comments-on-closed-functionality).</div>
This success criterion is problematic to apply directly to non-web software through simple word substitution because application titles rarely describe the topic or purpose of the software. However, where the platform supports a programmatic title or name for a software window or screen, when a software application utilizes that feature to provide a unique title or name for each window or screen, the user can more easily find it or understand its purpose. This would address the user needs identified in the [Intent from Understanding Success Criterion 2.4.2](https://www.w3.org/WAI/WCAG22/Understanding/page-titled#intent). The following criterion is recommended as a substitute for the WCAG language:
Copy link
Contributor

@daniel-montalvo daniel-montalvo Oct 30, 2025

Choose a reason for hiding this comment

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

Suggested change
This success criterion is problematic to apply directly to non-web software through simple word substitution because application titles rarely describe the topic or purpose of the software. However, where the platform supports a programmatic title or name for a software window or screen, when a software application utilizes that feature to provide a unique title or name for each window or screen, the user can more easily find it or understand its purpose. This would address the user needs identified in the [Intent from Understanding Success Criterion 2.4.2](https://www.w3.org/WAI/WCAG22/Understanding/page-titled#intent). The following criterion is recommended as a substitute for the WCAG language:
This success criterion is problematic to apply directly to non-web software through simple word substitution because application titles rarely describe the topic or purpose of the software. However, where the platform supports a programmatic title or name for a software window or screen, and/or when a software application utilizes that feature to provide a unique title or name for each window or screen, the user can more easily find it or understand its purpose. This would address the user needs identified in the [Intent from Understanding Success Criterion 2.4.2](https://www.w3.org/WAI/WCAG22/Understanding/page-titled#intent). The following criterion is recommended as a substitute for the WCAG language:

Purely editorial.

I think this one is missing "and/or" as we have in the documents part. In the case of software, we only have two subordinates so I think we need the connector.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@daniel-montalvo Non-web documents have the "and/or" on a different phrase that is not in the non-web software explanation. For non-web documents it is used on the phrase "and/or when a meaningful file name can be supplied" which is an alternate to utilizing the document technology's capability to supply a title or name inside of the document. So I don't think this change to use "and/or" should be made for non-web software.

Copy link
Contributor

@daniel-montalvo daniel-montalvo left a comment

Choose a reason for hiding this comment

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

Approving, just a minor editorial tweak for software on a suggestion above.

@maryjom
Copy link
Contributor Author

maryjom commented Oct 30, 2025

@daniel-montalvo I am merging without the suggested editorial change because using "and/or" in the non-web software guidance changes the meaning of that sentence - unlike where it is used in the non-web document guidance. (Detailed reasoning is in my previous comment.)

@maryjom maryjom merged commit 80da10e into main Oct 30, 2025
6 checks passed
github-actions bot added a commit that referenced this pull request Oct 30, 2025
SHA: 80da10e
Reason: push, by maryjom

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
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