Skip to content

Conversation

giacomo-petri
Copy link
Contributor

@giacomo-petri giacomo-petri commented Sep 22, 2025

Closes #3803

Description:
The current example does not accurately reflect the WCAG title structure and causes considerable confusion. Additionally, self-referential examples are difficult to maintain. For these reasons, I have replaced it with a static example.

Preview: https://deploy-preview-4631--wcag2.netlify.app/understanding/page-titled

Copy link

netlify bot commented Sep 22, 2025

Deploy Preview for wcag2 ready!

Name Link
🔨 Latest commit f87b910
🔍 Latest deploy log https://app.netlify.com/projects/wcag2/deploys/68deffb24bfef300096fc37c
😎 Deploy Preview https://deploy-preview-4631--wcag2.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

@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.

I prefer the current example because it's simpler and uses the generic heading of "a document collection". I agree it should be improved, and adding "landing page for…" is nice.

@bruce-usab
Copy link
Contributor

I was just looking at this page in the context of WCAG2ICT and thought the "document collection" example needed improvement. I am okay with using APG as that example, and it's nice to have an example with the vertical bars | since that is common nowadays.

preview diff

<dd>The descriptive title of an HTML web page is marked up with the &lt;title&gt; element so
that it will be displayed in the title bar of the user agent.</dd>
<dt>A document collection</dt>
<dt>A guide on authoring practices</dt>
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
<dt>A guide on authoring practices</dt>
<dt>A multi-page guide on authoring practices</dt>

Copy link
Contributor

Choose a reason for hiding this comment

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

We still need the simple titular category of "a document collection" or "set of web pages"

<li>Appendix C has the title "References."</li>
<li>
The patterns list page has the title "Patterns | APG | WAI | W3C"
<ul>
Copy link
Member

Choose a reason for hiding this comment

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

I think it's unnecessary and confusing to use nested (and then nested again, 3 levels) bullet points here. I get that the intention here is to also show hierarchy, but a simple straightforward set of bullet points will work best here I'd say

@bruce-usab
Copy link
Contributor

@giacomo-petri I took the liberty to move this back to "In Progress" but please be encouraged to put it under "For Discussion" if you would like feedback from the group.

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

Successfully merging this pull request may close these issues.

Success Criterion 2.4.2 -- Disconnect in the examples
3 participants