alphagov / govuk-design-system

One place for service teams to find styles, components and patterns for designing government services.
https://www.gov.uk/design-system
MIT License
512 stars 232 forks source link

Audit and fix our link text for screen reader users #4267

Open owenatgov opened 2 weeks ago

owenatgov commented 2 weeks ago

What

Review all our links on the website for quality of link text ie: if it can be understood out of context by a screen reader user, identify which links need improvment, write and deploy new link text.

Work related to this can be found in the accessible content audit worksheet (design system team access only).

On 6 November, we decided that we will first scope content improvements on links that:

We'll then assess any other improvements.

Why

This is to address 2 related issues raised in the 2024 DAC audit of the GOV.UK Design System website:

  1. https://github.com/alphagov/govuk-design-system/issues/4023
  2. https://github.com/alphagov/govuk-design-system/issues/4013

This issue will enable us to either resolve or explicitly decide not to solve these issues.

This issue is also split off from https://github.com/alphagov/govuk-design-system/issues/4193 in order to make the wider content audit work easier to manage.

Who needs to work on this

Website accessibiltiy squad (driven by content designer)

Who needs to review this

Website accessibiltiy squad

Done when

PRs to update links

kellylee-gds commented 2 weeks ago

Link text fixes scoped to component and patterns for now. Once fixes have been made on the website, we'll assess whether we have time and capacity to take on more link text edits this cycle

calvin-lau-sig7 commented 1 week ago

@owenatgov has been working on edits in the PR #4278. To support and document this work, I'm working to:

  1. create a step-by-step guide, expanding on the "Help assess descriptive links" directions in the worksheet – still to do as of 8/11)
  2. create a [rough style guide on how to edit link text as a Google Doc] – done as of 8/11, will update as work progresses (https://docs.google.com/document/d/1EAKA94PnLj847Dfq_N6kmePfA02TN_uNrrMg9ho5VTg/edit?usp=sharing)

Also, here's a sketch of the process steps I've done do far for step 1, attached.Image