Add banner to top of techniques pages, tweak boxout content about techniques#5002
Add banner to top of techniques pages, tweak boxout content about techniques#5002patrickhlauke wants to merge 6 commits intomainfrom
Conversation
✅ Deploy Preview for wcag2 ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
|
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... |
|
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”. |
|
How about adding this to the bottom of the "About this Technique" box: |
|
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) |
af6f04a to
1ca02c5
Compare
1ca02c5 to
970cf66
Compare
Co-authored-by: Patrick H. Lauke <[email protected]>
6e2100f to
d98760f
Compare
|
Based on feedback from the TF meeting, I also split up the big block of text I added to technique index and about into separate paragraphs |


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
Closes #3469
Previews: