Playbooks
Knowledge and self-service that everyone can use
Accessible, plain-language knowledge articles and portals that meet public sector duties.
Why it matters
Self-service portals and knowledge bases are public sector websites under the accessibility regulations. If staff or the public can't use them, they call the service desk instead, or give up. Accessible, plain-language knowledge is both a legal duty and a cost saving.
Writing knowledge articles
- Start with the task: title articles by what the reader is trying to do ("Reset your password"), not by the system's name.
- Use plain English: short sentences, common words, active voice. Explain acronyms the first time.
- Use real headings and lists, not bold text or tables for layout. Screen readers rely on structure.
- Describe images: every screenshot needs alternative text, and the steps should make sense without it.
- Don't rely on colour: "click the green button" fails for some readers.
- Write meaningful links: "read the remote access guide", not "click here".
- Avoid PDFs for anything people need to read on screen; use web pages.
- Keep personal data out, including in screenshots.
- Review regularly: give every article an owner and a review date.
The portal itself
- Meets WCAG 2.2 AA: test with keyboard only, screen magnification and a screen reader.
- Forms have labels, clear error messages, and don't time out without warning.
- Works on mobile.
- Has an accurate accessibility statement.
- Offers another way to get help, such as phone or face to face, for people who can't use it.
Welsh language
In Wales, Welsh language standards may require bilingual portals and articles. Plan translation into the knowledge workflow, so Welsh content is published at the same time as English, not weeks later.
Equality
Moving support online-only can disadvantage some people. Under the Equality Act 2010 (and section 75 in Northern Ireland), consider the impact before removing assisted channels, and keep alternatives for those who need them.
Measure what matters: searches with no results, articles that lead to a ticket anyway, and feedback. These show where knowledge is missing or unclear.