Fix accessibility issues by updating the govuk_tech_docs gem to 2.2.0 [before 31 March]

[36degrees]

What

First, update the govuk_tech_docs gem from 2.1.0 to 2.2.0.

Change log

2.2.0

Accessibility Fixes

• #205: Improve table of contents accessibility
• #209: Some search and keyboard navigation updates
• #210: Stop linking images to new tabs
• #214: Implement row level table headings to allow accessible tables with row headings
• #215: Add tabindex and focus states to code blocks

Docs

• #206: Remove tdt docs content from readme file

2.1.1

Fixes

We’ve made fixes in the following pull requests:

• #199: Fix page expiry box link colours (hover and focus)

Ruby version bump

We've updated the Ruby version supported:

• #201: Bump ruby to 2.7.2

Then identify and fix any tables which require row level headers.

There is a single table in migrating from legacy products, and multiple tables in the Sass API reference docs.

Why

Version 2.2.0 of the tech docs gem is now live and incorporates fixes to a number of accessibility issues in the technical documentation template which are referenced in our accessibility statement:

• Some tables in content do not have column row headers when needed.
• Users cannot tab to code examples to scroll them using the keyboard.
• The search field and the ‘Hide table of contents’ button are not placed logically in the focus order.
• Users can focus elements that are hidden visually behind other content, for example when using the search field.
• Images link to a new tab without telling users, and do not have link text.

Done when

• Gem updated
• Tables include row headers where required
• Verified that the issues listed in the accessibility statement are fixed (see guidance)

[EoinShaughnessy]

Have raised PR for Gemfile update: #106

[EoinShaughnessy]

Have raised PR for fix to migrating-from-legacy-products table: #107