You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
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:
"Techniques are examples, they may go beyond the minimum requirement of the criterion, and there may be other ways of meeting the criterion."
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)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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: