Skip to content

Add banner to top of techniques pages, tweak boxout content about techniques#5002

Open
patrickhlauke wants to merge 3 commits intomainfrom
patrickhlauke-techniques-banner
Open

Add banner to top of techniques pages, tweak boxout content about techniques#5002
patrickhlauke wants to merge 3 commits intomainfrom
patrickhlauke-techniques-banner

Conversation

@patrickhlauke
Copy link
Member

@patrickhlauke patrickhlauke commented Mar 17, 2026

As I constantly find myself having to explain to some folks that techniques are just informative (the amount of times I had to explain that even if a site doesn't use a particular documented technique, that's fine as long as the actual ask of the success criterion has been satisfied), this adds a standard boxout/disclaimer/note at the top of all techniques pages. This should catch folks who just "stumble" directly across a technique (from a search engine result or similar).

To go with it, this also expands the explanation given in the existing boxouts on the techniques index page and the about page.

Closes #1567

Previews:

@patrickhlauke patrickhlauke added Techniques Non-Normative Informative language in the specification or supporting materials labels Mar 17, 2026
@netlify
Copy link

netlify bot commented Mar 17, 2026

Deploy Preview for wcag2 ready!

Name Link
🔨 Latest commit 265de10
🔍 Latest deploy log https://app.netlify.com/projects/wcag2/deploys/69bc0009bfb2420008377221
😎 Deploy Preview https://deploy-preview-5002--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.

@patrickhlauke
Copy link
Member Author

Happy to iterate on this further, but this is a first naive implementation to get a better feel/idea of how it could work/look. Keeping in mind that we (well, > I <) do want it to be quite prominent to catch exactly those folks who don't read things, jump to a technique, and make wrong assumptions about what the purpose of techniques is...

@patrickhlauke patrickhlauke self-assigned this Mar 17, 2026
@yatil
Copy link
Contributor

yatil commented Mar 17, 2026

While my preference would be to not have techniques at all (but that is probably a ship that has sailed), a strong warning is a good compromise. I think one could bold “Techniques are examples”.

@alastc
Copy link
Contributor

alastc commented Mar 20, 2026

How about adding this to the bottom of the "About this Technique" box:
"Techniques are examples, they may go beyond the minimum requirement of the criterion, and there may be other ways of meeting the criterion."

@bruce-usab bruce-usab self-requested a review March 20, 2026 15:24
@patrickhlauke
Copy link
Member Author

Discussed in TF meeting. Will try to streamline the sentence and add it to the techniques' "About" box, as suggested, and to rework the addition in the "About techniques" boxout (move the extra prose further down in the page rather than in the boxout)

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

Labels

Non-Normative Informative language in the specification or supporting materials Techniques

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Adding disclaimer at the top of techniques?

3 participants