diff --git a/src/accessibility-statement.md b/src/accessibility-statement.md index 71f4245a6d..f0a183d031 100644 --- a/src/accessibility-statement.md +++ b/src/accessibility-statement.md @@ -97,9 +97,9 @@ 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 [Accessibility statement for Technical Documentation Template and documentation](https://github.com/alphagov/tdt-documentation/blob/main/source/accessibility/index.html.md.erb). diff --git a/src/accessibility/accessibility-strategy/index.md b/src/accessibility/accessibility-strategy/index.md index 6059cb1cd3..44425913ef 100644 --- a/src/accessibility/accessibility-strategy/index.md +++ b/src/accessibility/accessibility-strategy/index.md @@ -229,7 +229,7 @@ The team also uses general inspection techniques, including: 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: diff --git a/src/code-of-conduct.md b/src/code-of-conduct.md index 16bc156ebe..b8f29ab780 100644 --- a/src/code-of-conduct.md +++ b/src/code-of-conduct.md @@ -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.) --- diff --git a/src/community/code-of-conduct/index.md b/src/community/code-of-conduct/index.md index d72f945ff7..67687bd886 100644 --- a/src/community/code-of-conduct/index.md +++ b/src/community/code-of-conduct/index.md @@ -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 code of conduct](https://www.afrotechfest.co.uk/coc/), [Code for America code of conduct](http://www.cvent.com/events/code-for-america-summit-2018/custom-40-e12d85b157b94d69b80d8911cc641d36.aspx), [UKGovcamp code of conduct](https://www.ukgovcamp.com/code-of-conduct/), and [Services Week 2021 code of conduct](https://docs.google.com/document/d/1vQchJh-s6Fu6F4bN8UFM4lvRChe8ERgsE5whf9pUfjA/edit?usp=sharing) codes of conduct.) +(These guidelines are adapted from [Afrotech Fest code of conduct](https://www.afrotechfest.co.uk/coc/), [Code for America code of conduct](http://www.cvent.com/events/code-for-america-summit-2018/custom-40-e12d85b157b94d69b80d8911cc641d36.aspx), [UKGovcamp code of conduct](https://www.ukgovcamp.com/code-of-conduct/), and [Services Week 2021 code of conduct](https://docs.google.com/document/d/1vQchJh-s6Fu6F4bN8UFM4lvRChe8ERgsE5whf9pUfjA/edit?usp=sharing) codes of conduct.) diff --git a/src/community/contribution-criteria/index.md b/src/community/contribution-criteria/index.md index 85ca815057..c64eea9475 100644 --- a/src/community/contribution-criteria/index.md +++ b/src/community/contribution-criteria/index.md @@ -86,7 +86,7 @@ Before a new component or pattern is published the working group reviews the imp }, { html: '
It reuses existing styles and components in the Design System where relevant.
-Both the guidance and any content included in examples must follow the GOV.UK content style guide.
+Both the guidance and any content included in examples must follow the GOV.UK content style guide.
If there is code, it follows the GOV.UK Frontend coding standards and is ready to merge in GOV.UK Frontend.
' } ], @@ -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: diff --git a/src/community/design-system-day-2023/speaker-information.md b/src/community/design-system-day-2023/speaker-information.md index c89a6ca8d0..d9d0e9c544 100644 --- a/src/community/design-system-day-2023/speaker-information.md +++ b/src/community/design-system-day-2023/speaker-information.md @@ -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 diff --git a/src/community/develop-a-component-or-pattern/index.md b/src/community/develop-a-component-or-pattern/index.md index 4a3dc2f397..af17406aa2 100644 --- a/src/community/develop-a-component-or-pattern/index.md +++ b/src/community/develop-a-component-or-pattern/index.md @@ -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. diff --git a/src/components/exit-this-page/secondary-link/index.njk b/src/components/exit-this-page/secondary-link/index.njk index 5d0777b389..7afe211cb8 100644 --- a/src/components/exit-this-page/secondary-link/index.njk +++ b/src/components/exit-this-page/secondary-link/index.njk @@ -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" diff --git a/src/components/footer/index.md b/src/components/footer/index.md index 81cf29d45a..5d41be5139 100644 --- a/src/components/footer/index.md +++ b/src/components/footer/index.md @@ -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: - [your service's privacy notice](https://www.gov.uk/service-manual/design/collecting-personal-information-from-users) -- [your service's accessibility statement](https://www.gov.uk/service-manual/helping-people-to-use-your-service/publishing-information-about-your-services-accessibility) +- [your service's accessibility statement](https://www.gov.uk/guidance/make-your-website-or-app-accessible-and-publish-an-accessibility-statement) - [your service's Cookies page](/patterns/cookies-page/) - terms and conditions - other language options diff --git a/src/components/password-input/index.md b/src/components/password-input/index.md index 2ab15b7ec2..148ac985e0 100644 --- a/src/components/password-input/index.md +++ b/src/components/password-input/index.md @@ -149,7 +149,7 @@ Some browsers might automatically change what the user is typing when the input You can tell browsers not to correct spellings by setting the `spellcheck` attribute to `false`. -Doing this can also prevent ['spell-jacking'](https://www.otto-js.com/news/article/chrome-and-edge-enhanced-spellcheck-features-expose-pii-even-your-passwords), where security researchers have found some spell checking tools gathering personal identifiable information, even user’s passwords, from password input fields to send to third party services. +Doing this can also prevent ['spell-jacking'](https://www.itpro.com/security/vulnerability/370010/what-is-spell-jacking), where security researchers have found some spell checking tools gathering personal identifiable information, even user’s passwords, from password input fields to send to third party services. You can tell browsers not to autocapitalise values by setting the `autocapitalize` attribute to `off`. diff --git a/src/components/task-list/index.md b/src/components/task-list/index.md index aaf569ad3c..5918edb286 100644 --- a/src/components/task-list/index.md +++ b/src/components/task-list/index.md @@ -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" }) }} diff --git a/src/get-started/extending-and-modifying-components/index.md b/src/get-started/extending-and-modifying-components/index.md index a1535e530c..f276d4b034 100644 --- a/src/get-started/extending-and-modifying-components/index.md +++ b/src/get-started/extending-and-modifying-components/index.md @@ -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. diff --git a/src/get-started/production/index.md b/src/get-started/production/index.md index eef54dc8e6..6f81d5a8a9 100644 --- a/src/get-started/production/index.md +++ b/src/get-started/production/index.md @@ -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: @@ -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. diff --git a/src/patterns/confirm-a-phone-number/index.md b/src/patterns/confirm-a-phone-number/index.md index 92954f34c1..02ac06a886 100644 --- a/src/patterns/confirm-a-phone-number/index.md +++ b/src/patterns/confirm-a-phone-number/index.md @@ -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 diff --git a/src/patterns/contact-a-department-or-service-team/index.md b/src/patterns/contact-a-department-or-service-team/index.md index 7eb07f8da7..26e9a05be2 100644 --- a/src/patterns/contact-a-department-or-service-team/index.md +++ b/src/patterns/contact-a-department-or-service-team/index.md @@ -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 @@ -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. diff --git a/src/patterns/cookies-page/index.md b/src/patterns/cookies-page/index.md index f71bd4e94c..e94df33c46 100644 --- a/src/patterns/cookies-page/index.md +++ b/src/patterns/cookies-page/index.md @@ -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. diff --git a/src/patterns/create-accounts/index.md b/src/patterns/create-accounts/index.md index 69b2f967e1..f7c6013925 100644 --- a/src/patterns/create-accounts/index.md +++ b/src/patterns/create-accounts/index.md @@ -89,7 +89,3 @@ These are tests of cognitive function, which might be difficult for some users.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 3.3.8 Accessible authentication (minimum).
See more about using CAPTCHAs and why they’re problematic in the Service Manual. WCAG lists some other security measures you can implement to prevent misuse and automated abuse in your service.
{% 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). diff --git a/src/patterns/dates/index.md b/src/patterns/dates/index.md index 26f7a7c8e5..7af9468466 100644 --- a/src/patterns/dates/index.md +++ b/src/patterns/dates/index.md @@ -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. diff --git a/src/patterns/equality-information/index.md b/src/patterns/equality-information/index.md index ca8c3033c9..59d5871ff3 100644 --- a/src/patterns/equality-information/index.md +++ b/src/patterns/equality-information/index.md @@ -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. @@ -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. diff --git a/src/patterns/exit-a-page-quickly/index.md b/src/patterns/exit-a-page-quickly/index.md index ece11e5426..9693f963b1 100644 --- a/src/patterns/exit-a-page-quickly/index.md +++ b/src/patterns/exit-a-page-quickly/index.md @@ -106,6 +106,6 @@ Live examples of similar components can be found on these websites: - [GOV.UK: Check if you can get legal aid](https://www.gov.uk/check-legal-aid) - [GOV.UK: Apply for help arranging child maintenance](https://child-maintenance.service.gov.uk/apply/) -- [mygov.scot: Domestic abuse support](https://www.mygov.scot/domestic-abuse/) +- [mygov.scot: Domestic abuse support](https://www.mygov.scot/domestic-abuse) - [Women’s aid website](https://www.womensaid.org.uk/) - [Refuge website](https://www.nationaldahelpline.org.uk/) diff --git a/src/patterns/exit-a-page-quickly/safety-content-example/index.njk b/src/patterns/exit-a-page-quickly/safety-content-example/index.njk index 17af84ba8b..1c9d09a689 100644 --- a/src/patterns/exit-a-page-quickly/safety-content-example/index.njk +++ b/src/patterns/exit-a-page-quickly/safety-content-example/index.njk @@ -36,7 +36,7 @@ layout: layout-example-full-page.njk Google ChromePreviously, on 10 October 2024: We’ve released GOV.UK Frontend v5.7.0, which includes an update to the Royal Arms in the GOV.UK footer component. We’ve also added new features to help services create their own JavaScript components using GOV.UK Frontend.
Read the full release notes to see what’s changed.