Skip to content

Commit

Permalink
Fix broken external links
Browse files Browse the repository at this point in the history
  • Loading branch information
owenatgov committed Oct 24, 2024
1 parent b68d0ab commit 6cc2d93
Show file tree
Hide file tree
Showing 29 changed files with 40 additions and 44 deletions.
6 changes: 3 additions & 3 deletions src/accessibility-statement.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,11 +97,11 @@ DAC also tested the global search functionality that appears in the header of th

### Frontend documentation website

The [GOV.UK Frontend documentation website](http://frontend.design-system.service.gov.uk/) was last audited for accessibility issues by an external group in April 2021. The audit was carried out by the [Digital Accessibility Centre (DAC)](https://digitalaccessibilitycentre.org/).
The [GOV.UK Frontend documentation website](https://frontend.design-system.service.gov.uk/) was last audited for accessibility issues by an external group in April 2021. The audit was carried out by the [Digital Accessibility Centre (DAC)](https://digitalaccessibilitycentre.org/).

DAC tested the [Technical Documentation Template](https://tdt-documentation.london.cloudapps.digital/), which is the template for the GOV.UK Frontend documentation website.
DAC tested the [Technical Documentation Template](https://github.com/alphagov/tdt-documentation/), which is the template for the GOV.UK Frontend documentation website.

To learn more, read the [Technical Documentation Template accessibility statement](https://tdt-documentation.london.cloudapps.digital/accessibility/).
To learn more, read the [Technical Documentation Template accessibility statement](https://github.com/alphagov/tdt-documentation/blob/main/source/accessibility/index.html.md.erb).

### Frontend codebase

Expand Down
6 changes: 3 additions & 3 deletions src/accessibility/accessibility-strategy/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -221,15 +221,15 @@ The team uses a variety of tools during the development process, including, but

The team also uses general inspection techniques, including:

- [sensory inspection](https://web.dev/a11y-tips-for-web-dev/) (visual, auditory, etc.)
- HTML inspection using [browser developer tools](https://developer.mozilla.org/en-US/docs/Learn/Common_questions/What_are_browser_developer_tools)
- [sensory inspection](https://web.dev/articles/a11y-tips-for-web-dev) (visual, auditory, etc.)
- HTML inspection using [browser developer tools](https://developer.mozilla.org/en-US/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools)
- [accessibility tree](https://developer.mozilla.org/en-US/docs/Glossary/Accessibility_tree) inspection

### Automated testing

The team currently uses [jest-axe](https://github.com/nickcolley/jest-axe) as part of our deployment process, along with [@axe-core/puppeteer](https://github.com/dequelabs/axe-core-npm/blob/develop/packages/puppeteer). These tools test the example code snippets in the GOV.UK Design System against [axe-core](https://github.com/dequelabs/axe-core).

The team does not solely rely on automated testing processes, as a 2017 study from GDS concluded that [only about 30% of issues are found by automated testing tools](https://accessibility.blog.gov.uk/2017/02/24/what-we-found-when-we-tested-tools-on-the-worlds-least-accessible-webpage), such as axe-core.
The team does not solely rely on automated testing processes, as a 2017 study from GDS concluded that [only about 30% of issues are found by automated testing tools](https://accessibility.blog.gov.uk/2017/02/24/what-we-found-when-we-tested-tools-on-the-worlds-least-accessible-webpage/), such as axe-core.

As of May 2023, we have improved our automated accessibility testing processes:

Expand Down
2 changes: 1 addition & 1 deletion src/code-of-conduct.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ List of organisers:
- Steve Messer
- Tallulah Jackson-Marriott

(These guidelines are adapted from the [Practical Service Design](http://www.practicalservicedesign.com/getting-started-on-slack/) community guidelines, [Afrotech Fest](https://www.afrotechfest.co.uk/coc/), [Code for America](http://www.cvent.com/events/code-for-america-summit-2018/custom-40-e12d85b157b94d69b80d8911cc641d36.aspx), [UKGovcamp](https://www.ukgovcamp.com/code-of-conduct/), and [Services Week 2021](https://docs.google.com/document/d/1vQchJh-s6Fu6F4bN8UFM4lvRChe8ERgsE5whf9pUfjA/edit?usp=sharing) codes of conduct.)
(These guidelines are adapted from [Afrotech Fest](https://www.afrotechfest.co.uk/coc/), [Code for America](http://www.cvent.com/events/code-for-america-summit-2018/custom-40-e12d85b157b94d69b80d8911cc641d36.aspx), [UKGovcamp](https://www.ukgovcamp.com/code-of-conduct/), and [Services Week 2021](https://docs.google.com/document/d/1vQchJh-s6Fu6F4bN8UFM4lvRChe8ERgsE5whf9pUfjA/edit?usp=sharing) codes of conduct.)

---

Expand Down
2 changes: 1 addition & 1 deletion src/community/code-of-conduct/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,4 +43,4 @@ List of organisers:
- Romaric Pascal
- Trang Erskine

(These guidelines are adapted from the [Practical Service Design](http://www.practicalservicedesign.com/getting-started-on-slack/) community guidelines, [Afrotech Fest](https://www.afrotechfest.co.uk/coc/), [Code for America](http://www.cvent.com/events/code-for-america-summit-2018/custom-40-e12d85b157b94d69b80d8911cc641d36.aspx), [UKGovcamp](https://www.ukgovcamp.com/code-of-conduct/), and [Services Week 2021](https://docs.google.com/document/d/1vQchJh-s6Fu6F4bN8UFM4lvRChe8ERgsE5whf9pUfjA/edit?usp=sharing) codes of conduct.)
(These guidelines are adapted from [Afrotech Fest](https://www.afrotechfest.co.uk/coc/), [Code for America](http://www.cvent.com/events/code-for-america-summit-2018/custom-40-e12d85b157b94d69b80d8911cc641d36.aspx), [UKGovcamp](https://www.ukgovcamp.com/code-of-conduct/), and [Services Week 2021](https://docs.google.com/document/d/1vQchJh-s6Fu6F4bN8UFM4lvRChe8ERgsE5whf9pUfjA/edit?usp=sharing) codes of conduct.)
4 changes: 2 additions & 2 deletions src/community/contribution-criteria/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ Before a new component or pattern is published the working group reviews the imp
},
{
html: '<p>It reuses existing styles and components in the Design System where relevant.</p>
<p>Both the guidance and any content included in examples must follow the <a href="https://www.gov.uk/guidance/style-guide/a-to-z-of-gov-uk-style">GOV.UK content style guide</a>.</p>
<p>Both the guidance and any content included in examples must follow the <a href="https://www.gov.uk/guidance/style-guide/a-to-z">GOV.UK content style guide</a>.</p>
<p class="govuk-!-margin-bottom-0">If there is code, it follows the <a href="https://github.com/alphagov/govuk-frontend/blob/main/CONTRIBUTING.md#conventions-to-follow">GOV.UK Frontend coding standards</a> and is ready to merge in GOV.UK Frontend.</p>'
}
],
Expand Down Expand Up @@ -116,7 +116,7 @@ Before linking from the Design System to a [community resource or tool](/communi
- design resources are consistent with the styles, components and patterns in the GOV.UK Design System
- development resources output the same markup as GOV.UK Frontend
- it is not being charged for or used to promote a private business
- it's compatible with the [Service Standard](https://www.gov.uk/service-manual/service-standard) and [Technology code of practice](https://www.gov.uk/government/publications/technology-code-of-practice/technology-code-of-practice)
- it's compatible with the [Service Standard](https://www.gov.uk/service-manual/service-standard) and [Technology code of practice](https://www.gov.uk/guidance/the-technology-code-of-practice)

To help users decide whether to use your resource or tool and tell them how to get support for it, add this message to the resource README and after any website links:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ Sam is the Head of Design in Digital Transformation, Digital Directorate, Scotti

### Jennifer I'Anson (Scottish Government)

Jennifer is a lead product manager within the Digital directorate of the Scottish Government responsible for [mygov.scot](https://mygov.scot) and [gov.scot](https://gov.scot). She is also Product Owner of the Scottish Government’s Design System from its inception, helping launch it during the pandemic.
Jennifer is a lead product manager within the Digital directorate of the Scottish Government responsible for [mygov.scot](https://www.mygov.scot) and [gov.scot](https://www.gov.scot). She is also Product Owner of the Scottish Government’s Design System from its inception, helping launch it during the pandemic.

### GOV.UK Design System team

Expand Down
2 changes: 1 addition & 1 deletion src/community/develop-a-component-or-pattern/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ The following principles will help you research and develop your contribution.

### Start with what exists

Find examples of the component or pattern already in use. The best way to do this is to ask the government design community on the [digital service designers mailing list](https://groups.google.com/a/digital.cabinet-office.gov.uk/forum/?hl=en-GB#!forum/digital-service-designers) or the [#design channel on cross-government Slack](https://ukgovernmentdigital.slack.com/app_redirect?channel=design).
Find examples of the component or pattern already in use. The best way to do this is to ask the government design community on the [digital service designers mailing list](https://groups.google.com/a/digital.cabinet-office.gov.uk/g/digital-service-designers) or the [#design channel on cross-government Slack](https://ukgovernmentdigital.slack.com/app_redirect?channel=design).

Examples and research from government services are usually most relevant. But look at how other organisations solve the problem too.

Expand Down
2 changes: 1 addition & 1 deletion src/community/resources-and-tools/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ SVG images for creating flow diagrams of GOV.UK services.
[Balsamiq wireframes](https://github.com/enoranidi/govuk-design-system-balsamiq) -
Balsamiq wireframes based on the GOV.UK Design System.

[Figma resources](https://www.figma.com/file/NWuFffKvPQhl3aJ9nKU0p3/GOV.UK-Design-System) -
[Figma resources](https://www.figma.com/design/NWuFffKvPQhl3aJ9nKU0p3/GOV.UK-Design-System) -
Figma library of styles and components based on the GOV.UK Design System.

[Mural resources](https://github.com/vickytnz/govuk-elements-mural) -
Expand Down
2 changes: 1 addition & 1 deletion src/components/exit-this-page/secondary-link/index.njk
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ layout: layout-example.njk

{{ govukSkipLink({
text: "Exit this page",
href: "https://bbc.co.uk/weather/",
href: "https://www.bbc.co.uk/weather",
classes: "govuk-js-exit-this-page-skiplink",
attributes: {
"rel": "nofollow noreferrer"
Expand Down
2 changes: 1 addition & 1 deletion src/components/footer/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ Make it clear whether content is available for re-use - and if it is, under what
You can add links to:

- [privacy notice](https://www.gov.uk/service-manual/design/collecting-personal-information-from-users)
- [accessibility statement](https://www.gov.uk/service-manual/helping-people-to-use-your-service/publishing-information-about-your-services-accessibility)
- [accessibility statement](https://www.gov.uk/government/publications/sample-accessibility-statement/sample-accessibility-statement-for-a-fictional-public-sector-website)
- [cookies page](/patterns/cookies-page/)
- terms and conditions
- other language options
Expand Down
2 changes: 1 addition & 1 deletion src/components/task-list/index.md.njk
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ The task list should not be used as a way of showing users their answers. For th

## How it works

There are 2 ways to use the task list component. You can use HTML or, if you’re using [Nunjucks](https://mozilla.github.io/nunjucks/) or the [GOV.UK Prototype Kit](https://govuk-prototype-kit.herokuapp.com), you can use the Nunjucks macro.
There are 2 ways to use the task list component. You can use HTML or, if you’re using [Nunjucks](https://mozilla.github.io/nunjucks/) or the [GOV.UK Prototype Kit](https://prototype-kit.service.gov.uk/docs/), you can use the Nunjucks macro.

{{ example({ group: "components", item: "task-list", example: "default", html: true, nunjucks: true, open: false, titleSuffix: "second" }) }}

Expand Down
4 changes: 2 additions & 2 deletions src/get-started/extending-and-modifying-components/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -104,9 +104,9 @@ For example, to define a custom width for a specific reference number in your se

## Small modifications to components

The GOV.UK Design System uses a naming convention called [Block Element Modifier (BEM)](http://getbem.com/) which makes it easier to ensure styling is isolated to individual components. You can use this convention to make modifications to components.
The GOV.UK Design System uses a naming convention called [Block Element Modifier (BEM)](https://getbem.com/) which makes it easier to ensure styling is isolated to individual components. You can use this convention to make modifications to components.

When making small modifications to components you can make use of the [modifier convention from BEM](http://getbem.com/naming/), which uses a suffix of `--` plus a name, alongside your own [prefix].
When making small modifications to components you can make use of the [modifier convention from BEM](https://getbem.com/naming/), which uses a suffix of `--` plus a name, alongside your own [prefix].

For example, if you wanted to override the button component you could do the following.

Expand Down
4 changes: 2 additions & 2 deletions src/get-started/production/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ There are 2 ways to include GOV.UK Frontend in your project. You can either inst

### Option 1: install using npm

We recommend [installing GOV.UK Frontend using npm](https://frontend.design-system.service.gov.uk/installing-with-npm/#install-with-node-js-package-manager-npm).
We recommend [installing GOV.UK Frontend using npm](https://frontend.design-system.service.gov.uk/installing-with-npm/).

Using this option, you will be able to:

Expand All @@ -37,7 +37,7 @@ Using this option, you will be able to:

### Option 2: include compiled files

If your project does not use npm, or if you want to try out GOV.UK Frontend in your project without installing it through npm, you can [download and include compiled stylesheets, JavaScript and the asset files](https://frontend.design-system.service.gov.uk/installing-from-dist/#install-from-dist).
If your project does not use npm, or if you want to try out GOV.UK Frontend in your project without installing it through npm, you can [download and include compiled stylesheets, JavaScript and the asset files](https://frontend.design-system.service.gov.uk/install-using-precompiled-files/).

Using this option, you will be able to include all the CSS and JavaScript of GOV.UK Frontend in your project.

Expand Down
2 changes: 1 addition & 1 deletion src/patterns/confirm-a-phone-number/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -144,7 +144,7 @@ Set up monitoring for potentially malicious behaviour, such as activity from une

## Research on this pattern

[Read the National Cyber Security Centre’s guidance on multi-factor authentication](https://www.ncsc.gov.uk/guidance/multi-factor-authentication-online-services).
[Read the National Cyber Security Centre’s guidance on multi-factor authentication](https://www.ncsc.gov.uk/collection/mfa-for-your-corporate-online-services).

### Services using this pattern

Expand Down
4 changes: 2 additions & 2 deletions src/patterns/contact-a-department-or-service-team/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ If you have social media channels:

### Write phone numbers in the GOV.UK style

See the [GOV.UK style for writing phone numbers](https://www.gov.uk/guidance/style-guide/a-to-z-of-gov-uk-style#phone-numbers).
See the [GOV.UK style for writing phone numbers](https://www.gov.uk/guidance/style-guide/a-to-z#telephone-numbers).

### Explain any charges

Expand All @@ -71,7 +71,7 @@ For phone call charges, link to the GOV.UK page on [call charges](https://www.go

### Give opening hours

Follow the GOV.UK style guide format for [time ranges](https://www.gov.uk/guidance/style-guide/a-to-z-of-gov-uk-style#times) and [date ranges](https://www.gov.uk/guidance/style-guide/a-to-z-of-gov-uk-style#dates).
Follow the GOV.UK style guide format for [time ranges](https://www.gov.uk/guidance/style-guide/a-to-z#times) and [date ranges](https://www.gov.uk/guidance/style-guide/a-to-z#dates).

Explain any exceptions, like bank holidays, or days of the week when your opening hours are different.

Expand Down
2 changes: 1 addition & 1 deletion src/patterns/cookies-page/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ Have an agreed process for updating the cookie policy when you add or remove a c

You do not need the user’s consent to set essential or ‘strictly necessary’ cookies. A cookie is ‘strictly necessary’ if the service will not work without it.

The Information Commissioner’s Office (ICO) has [guidance on what types of cookie are likely to be considered ‘strictly necessary’](https://ico.org.uk/for-organisations/guide-to-pecr/guidance-on-the-use-of-cookies-and-similar-technologies/what-are-the-rules-on-cookies-and-similar-technologies/). For example, load balancing cookies are likely to be strictly necessary - but cookies that collect analytics data are not.
The Information Commissioner’s Office (ICO) has [guidance on what types of cookie are likely to be considered ‘strictly necessary’](https://ico.org.uk/for-organisations/direct-marketing-and-privacy-and-electronic-communications/guide-to-pecr/guidance-on-the-use-of-cookies-and-similar-technologies/what-are-the-rules-on-cookies-and-similar-technologies/). For example, load balancing cookies are likely to be strictly necessary - but cookies that collect analytics data are not.

You must get the user’s consent before you set any cookies that are not strictly necessary.

Expand Down
4 changes: 0 additions & 4 deletions src/patterns/create-accounts/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,3 @@ These are tests of cognitive function, which might be difficult for some users.
<p>Avoid making users do a cognitive test to use your service. If you do, you must also offer an alternative method. This is to comply with WCAG 2.2 success criterion <a href="https://www.w3.org/WAI/WCAG22/Understanding/accessible-authentication-minimum">3.3.8 Accessible authentication (minimum)</a>.</p>
<p>See more about <a href="https://www.gov.uk/service-manual/technology/using-captchas">using CAPTCHAs and why they’re problematic</a> in the Service Manual. <a href="https://www.w3.org/WAI/WCAG22/Understanding/accessible-authentication-minimum#object-recognition">WCAG lists some other security measures</a> you can implement to prevent misuse and automated abuse in your service.</p>
{% endcall %}

### Never use National Insurance numbers to verify a user’s identity

If you currently use National Insurance numbers to verify identity, find out how to [protect your service against fraud](https://www.gov.uk/service-manual/technology/protecting-your-service-against-fraud#avoid-using-national-insurance-numbers-to-verify-identity).
2 changes: 1 addition & 1 deletion src/patterns/dates/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ Never make a calendar control that depends on JavaScript as the only input optio

### How to write dates

See the [GOV.UK style for writing dates](https://www.gov.uk/guidance/style-guide/a-to-z-of-gov-uk-style#dates) and [date ranges](https://www.gov.uk/guidance/content-design/writing-for-gov-uk#date-ranges).
See the [GOV.UK style for writing dates](https://www.gov.uk/guidance/style-guide/a-to-z#dates) and [date ranges](https://www.gov.uk/guidance/content-design/writing-for-gov-uk#date-ranges).

If you give an example date, use 13 or more for the day and 9 or less for the month - for example ‘27 3 2007’. This helps users enter the date in the correct order and shows them they do not need to include leading zeroes.

Expand Down
4 changes: 2 additions & 2 deletions src/patterns/equality-information/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,7 +80,7 @@ Updating equality information is especially relevant for longer term services an

## Get specialist privacy or data protection advice

Some or all of the equality information you collect is likely to be what’s called ‘[special category personal data](https://ico.org.uk/for-organisations/guide-to-data-protection/guide-to-the-general-data-protection-regulation-gdpr/special-category-data/what-is-special-category-data/)’, meaning it has special legal protections.
Some or all of the equality information you collect is likely to be what’s called ‘[special category personal data](https://ico.org.uk/for-organisations/uk-gdpr-guidance-and-resources/lawful-basis/special-category-data/what-is-special-category-data/)’, meaning it has special legal protections.

So before you start collecting equality information, it’s important to get advice and approval from your organisation’s privacy or data protection expert on how to collect and process the information.

Expand Down Expand Up @@ -126,7 +126,7 @@ If the user answers ‘yes’, ask about the impact of their condition or illnes

### Asking about ethnic group

The ethnic groups used here are for England. The Government Statistical Service harmonised standard for ethnicity uses [different categories for Wales, Scotland and Northern Ireland](https://gss.civilservice.gov.uk/policy-store/ethnicity/). This is to reflect differences in local populations.
The ethnic groups used here are for England. The Government Statistical Service harmonised standard for ethnicity uses [different categories for Wales, Scotland and Northern Ireland](https://analysisfunction.civilservice.gov.uk/policy-store/ethnicity-harmonised-standard/). This is to reflect differences in local populations.

If your service covers more than one of England, Wales, Scotland or Northern Ireland, you should accommodate these differences in your design. For example, by changing the ethnic groups shown depending on where the user is based. Where this is not possible, use the English categories.

Expand Down
Loading

0 comments on commit 6cc2d93

Please sign in to comment.