Content quality
Each page is reviewed against five lenses: clarity, ambiguity control, structure, terminology and actionability. Read more about the MDS Authoring Kit for how we rate and maintain content quality.
Components
Guidelines
How to read the dashboard
Each page gets an overall Quality (High, Medium or Low) and is reviewed against five lenses: Clarity, Ambiguity control, Structure, Terminology and Actionability. Each lens has one of three ratings:
- Strong
- Mixed
- Weak
The five lenses each ask one question:
- Clarity: Is the wording easy to understand? This is about how each sentence reads. A sentence is unclear if it is a confusing fragment, has no clear subject, or contradicts another sentence.
- Ambiguity control: Does the text have only one reasonable meaning? This is about whether different readers would act differently on the same sentence. A sentence can read smoothly and still be open to two readings. Strong means little room for that.
- Structure: Can the reader find what they need, in a sensible order? This is about how the page is organised, not how the sentences read. Guidance is hard to use if related points are far apart, or a topic comes before the idea it depends on.
- Terminology: Are key terms defined and used the same way each time? This is about the words, not the sentences. A term causes problems if it is never explained, or if the page uses two different words for the same thing.
- Actionability: Can the reader act on the guidance without making up rules? This is about whether the page tells you what to do. A page can be clear and well organised and still describe a topic without saying when to do something, or what to do.
Select a page to see every rating it has had, the reason for each, the date of the review and a link to the full review. If the page has changed since its latest review, the rating is marked Out of date and may no longer apply.
A rating is a guide to where a page can improve. It is not a gate: a page is never blocked from publishing because of its rating.