In this lesson you
- Read a category's counts and colors
- Went from a rule's name to its panel
- Fixed it there, or followed it to its step
Transcript
One rule, on its own
Fixing one rule from the WCAG report. Sometimes the work arrives as a rule's name. An auditor's note says Primary language fails, or another checker flags it. How do you go straight to that one rule? The steps group the work by the decision you make. The WCAG report lists the same work rule by rule, so you can find any rule by its name. This notice is tagged, titled and easy to read. One rule still fails.
Reading the report
To see every rule Proof checks on this document, choose WCAG Report, at the top of the steps. The two counts at the top sum up the whole document. Here, one rule to fix and two to review. Below them, the rules are grouped into categories. Each row counts its rules, and how many are to fix or to review. The small bar on the right shows the same counts as colors. Red is a rule that fails. Amber is one a person still has to review. Green has passed. Grey is a rule that doesn't apply, or one marked advisory. Advisory means a technical PDF finding that doesn't count toward the WCAG verdict. The Document category has the one rule to fix. Open it to see its rules. Each rule shows its name, a line about what it checks, and a pill with where it stands. Under the name is the step where its work is done. Primary language belongs to the Machine pass. Primary language has failed. The file never says what language it's written in. A screen reader then has to guess. It may read the English text with the wrong voice, and the wrong pronunciation.
Fixing it from its panel
Opening a rule shows its own panel. Most of the time, that's the same panel a step would show you. When a rule's work belongs to a step, like reading order, the report shows what was found, and a button that takes you to that step. It reads Fix this in, then the step's name. If you want the rule explained, select the question mark beside its name. It says what Proof does for this rule, and where it stops. Primary language is fixed right here. Current language reads Not set. This notice is in English, so pick English, United States, from the quick picks. Then choose Save language. Proof writes the language into a new version of the file, and checks the rule again. The version at the top now reads v2. The first version stays in the history, unchanged.
Back to the steps
Primary language now passes, and the panel says what comes next. This rule is clear. The button beside it opens the next rule with work left, logical reading order, in Reading. When you're done with the report, choose Steps to go back to where you were. The automatic pass has nothing left to run on version two. What's left is in Reading. Now you can find any rule by its name, read where it stands, and fix it from its own panel or go to the step that does.
Recap
That's the end of this lesson.
Maple Ridge Community Health, its documents and its people are fictional, made for these lessons.