From aa9b6550f7378c0bc0fb53db16b361b065fbfaa5 Mon Sep 17 00:00:00 2001 From: Calvin Lau Date: Thu, 14 Nov 2024 14:50:51 +0000 Subject: [PATCH] Update the links on homepage, root pages and Get Started sections Co-Authored-By: Calvin Lau <77630796+calvin-lau-sig7@users.noreply.github.com> --- src/accessibility-statement.md | 18 +++++++++--------- src/get-started/focus-states/index.md | 4 ++-- src/get-started/index.md | 6 +++--- src/get-started/production/index.md | 18 +++++++++--------- src/get-started/prototyping/index.md | 2 +- src/index.njk | 8 ++++---- src/privacy-policy.md | 2 +- 7 files changed, 29 insertions(+), 29 deletions(-) diff --git a/src/accessibility-statement.md b/src/accessibility-statement.md index d83327cad7..71f4245a6d 100644 --- a/src/accessibility-statement.md +++ b/src/accessibility-statement.md @@ -85,13 +85,13 @@ The [GOV.UK Design System website](https://design-system.service.gov.uk/) was la DAC tested a sample of pages to cover the different content types in the GOV.UK Design System website. They were: -- [the homepage](https://design-system.service.gov.uk/) -- [a short content page](https://design-system.service.gov.uk/community/design-system-working-group/) -- [a long content page](https://design-system.service.gov.uk/styles/layout/) -- [an overview page](https://design-system.service.gov.uk/community/) -- [a styles page](https://design-system.service.gov.uk/styles/headings/) -- [a component page](https://design-system.service.gov.uk/components/radios/) -- [a pattern page](https://design-system.service.gov.uk/patterns/question-pages/) +- the [GOV.UK Design System homepage](https://design-system.service.gov.uk/) +- a short content page: [Design System working group](https://design-system.service.gov.uk/community/design-system-working-group/) +- a long content page: [Layout styles](https://design-system.service.gov.uk/styles/layout/) +- an overview page: [Community section](https://design-system.service.gov.uk/community/) +- a styles page: [Headings styles](https://design-system.service.gov.uk/styles/headings/) +- a component page: [Radios component](https://design-system.service.gov.uk/components/radios/) +- a pattern page: [Question pages pattern](https://design-system.service.gov.uk/patterns/question-pages/) DAC also tested the global search functionality that appears in the header of the GOV.UK Design System website. @@ -101,11 +101,11 @@ The [GOV.UK Frontend documentation website](http://frontend.design-system.servic DAC tested the [Technical Documentation Template](https://tdt-documentation.london.cloudapps.digital/), 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 [Accessibility statement for Technical Documentation Template and documentation](https://github.com/alphagov/tdt-documentation/blob/main/source/accessibility/index.html.md.erb). ### Frontend codebase -The GOV.UK Frontend codebase is not a website but a [code repository](https://github.com/alphagov/govuk-frontend) and [npm package](https://www.npmjs.com/package/govuk-frontend). +The GOV.UK Frontend codebase is not a website but a [code repository on GitHub](https://github.com/alphagov/govuk-frontend) and [a software package on npm (Node Package Manager)](https://www.npmjs.com/package/govuk-frontend). Examples using the GOV.UK Frontend codebase were last audited for accessibility issues by an external group in May 2023. The audit was carried out by the [Digital Accessibility Centre (DAC)](https://digitalaccessibilitycentre.org/). diff --git a/src/get-started/focus-states/index.md b/src/get-started/focus-states/index.md index 9a0b7b975c..b17571a15c 100644 --- a/src/get-started/focus-states/index.md +++ b/src/get-started/focus-states/index.md @@ -9,7 +9,7 @@ description: Some people use keyboards or other devices to navigate through a pa Some people use keyboards or other devices to navigate through a page by jumping from one interactive element to the next. Focus states let users know which element they’re currently on and is ready to be interacted with. -Focus states in the GOV.UK Design System use a combination of yellow and black to make sure they meet Web Content Accessibility Guidelines (WCAG) 2.1 level AA [non-text contrast](https://www.w3.org/WAI/WCAG21/Understanding/non-text-contrast.html) on any background colour used on GOV.UK. +Focus states in the GOV.UK Design System use a combination of yellow and black to make sure they meet [Web Content Accessibility Guidelines (WCAG) 2.2 success criterion 1.4.11 Non-text Contrast (Level AA)](https://www.w3.org/WAI/WCAG21/Understanding/non-text-contrast.html) on any background colour used on GOV.UK. The yellow has a high contrast with dark backgrounds and the thick black border has a high contrast against light backgrounds. @@ -68,7 +68,7 @@ Use these variables in your components instead of numeric values for the backgro To make a component's focus state accessible without using Sass, you can: -- see how the `govuk-focused-text` mixin works from the [GOV.UK Frontend source code](https://github.com/alphagov/govuk-frontend/blob/25a4333b239e1c3b8a136e526981fe29172a2852/src/govuk/helpers/_focused.scss#L12-L28) +- use the `govuk-focused-text` mixin – [see how `govuk-focused-text` works in the GOV.UK Frontend source code](https://github.com/alphagov/govuk-frontend/blob/25a4333b239e1c3b8a136e526981fe29172a2852/src/govuk/helpers/_focused.scss#L12-L28) - get the values for `$govuk-focus-colour` and `$govuk-focus-text-colour` from the [colour page](/styles/colour/) ## Contributing back diff --git a/src/get-started/index.md b/src/get-started/index.md index 1b1631c821..a7a0d80eac 100644 --- a/src/get-started/index.md +++ b/src/get-started/index.md @@ -9,12 +9,12 @@ The examples in the GOV.UK Design System come with code to make it easy for you There are guides to getting started: -- [prototyping](prototyping/) -- [in production](production/) +- [with prototyping](prototyping/) +- [working in production](production/) ## Using styles, components and patterns -When something is published in the GOV.UK Design System as a [style](/styles/), [component](/components/) or [pattern](/patterns/) we include details of how and when it’s been tested in user research. This should help you decide whether it’s something you can use or adapt for your service. +When we publish new [styles](/styles/), [components](/components/) or [patterns](/patterns/) we include details of how and when it’s been tested in user research. This should help you decide whether it’s something you can use or adapt for your service. You can ask questions or share your research by joining the discussion on GitHub. There are links at the end of each style, component and pattern page - under the ‘Help improve this page’ heading. diff --git a/src/get-started/production/index.md b/src/get-started/production/index.md index 7bebfd7941..eef54dc8e6 100644 --- a/src/get-started/production/index.md +++ b/src/get-started/production/index.md @@ -14,7 +14,7 @@ This guide explains how to set up your project so you can start using the styles {{ govukInsetText({ classes: "app-table--constrained", - html: 'If you’ve used GOV.UK Elements, GOV.UK Template or the GOV.UK Frontend Toolkit before, you might also find it useful to read the guide on updating your code.' + html: 'If you’ve used GOV.UK Elements, GOV.UK Template or the GOV.UK Frontend Toolkit before, you might also find it useful to read the guide to Migrate from our old frameworks.' }) }} ## Include GOV.UK Frontend in your project @@ -29,11 +29,11 @@ We recommend [installing GOV.UK Frontend using npm](https://frontend.design-syst Using this option, you will be able to: -- selectively [include the CSS](https://frontend.design-system.service.gov.uk/import-css/) for individual components -- selectively [include the JavaScript](https://frontend.design-system.service.gov.uk/import-javascript/) for individual components +- [selectively include the CSS for individual components](https://frontend.design-system.service.gov.uk/import-css/) +- [selectively include the JavaScript individual components](https://frontend.design-system.service.gov.uk/import-javascript/) for - build your own styles or components based on the palette or typography and spacing mixins - customise the build (for example, overriding colours or enabling global styles) -- use the [Nunjucks template and macros](https://frontend.design-system.service.gov.uk/use-nunjucks/) if your environment supports them +- use [our Nunjucks template and macros](https://frontend.design-system.service.gov.uk/use-nunjucks/) if your environment supports them ### Option 2: include compiled files @@ -43,15 +43,15 @@ Using this option, you will be able to include all the CSS and JavaScript of GOV You will not be able to: -- selectively [include the CSS](https://frontend.design-system.service.gov.uk/import-css/) for individual components -- selectively [include the JavaScript](https://frontend.design-system.service.gov.uk/import-javascript/) for individual components +- [selectively include the CSS for individual components](https://frontend.design-system.service.gov.uk/import-css/) +- [selectively include the JavaScript for individual components](https://frontend.design-system.service.gov.uk/import-javascript/) - build your own styles or components based on the palette or typography and spacing mixins - customise the build, for example, overriding colours or enabling global styles - use the component Nunjucks templates ## Start using the GOV.UK page template -You can set up a basic page that is consistent with GOV.UK branding by using the [GOV.UK page template](/styles/page-template/). +You can set up a basic page that is consistent with GOV.UK branding by [using the GOV.UK page template](/styles/page-template/). ## Styling page elements @@ -59,7 +59,7 @@ The Design System provides CSS classes for styling content, instead of global st The class names follow the Block Element Modifier (BEM) naming convention. This can look a bit daunting at first, but it makes robust code that’s easy to maintain. -Explore the [Styles](/styles/) section of the Design System to see what classes are available. +Explore the [Styles section](/styles/) of the Design System to see what classes are available. ## Using components @@ -68,7 +68,7 @@ The components in the Design System are designed to be accessible and responsive You can use them in your live application as either: - HTML -- [Nunjucks macros](https://frontend.design-system.service.gov.uk/use-nunjucks/) - if you installed GOV.UK Frontend using npm and your application uses Node.js +- [our Nunjucks macros](https://frontend.design-system.service.gov.uk/use-nunjucks/), if you've installed GOV.UK Frontend using npm and your application uses Node.js You can get the code from the HTML or Nunjucks tabs below any examples: diff --git a/src/get-started/prototyping/index.md b/src/get-started/prototyping/index.md index 47989b8630..53a50d247d 100644 --- a/src/get-started/prototyping/index.md +++ b/src/get-started/prototyping/index.md @@ -23,7 +23,7 @@ This means that any code that you copy across from old prototypes will not displ The Design System provides lots of new CSS classes for styling page elements, so you should not need to write as much of your own Sass or CSS. -Explore the [Styles](/styles/) section of the Design System to see what classes are available and how to apply them. +Explore the [Styles section](/styles/) of the Design System to see what classes are available and how to apply them. ## Using components diff --git a/src/index.njk b/src/index.njk index 07afd5edfb..3b15383462 100644 --- a/src/index.njk +++ b/src/index.njk @@ -13,17 +13,17 @@ masthead: true

Styles

Make government services look like GOV.UK with guides for applying layout, typography, colour and images.

-

Browse styles

+

Browse our styles

Components

Save time with reusable, accessible components for forms, navigation, panels, tables and more.

-

Browse components

+

Browse our components

Patterns

Help users complete common tasks like entering names and addresses, filling in forms and creating accounts.

-

Browse patterns

+

Browse our patterns

@@ -33,7 +33,7 @@ masthead: true

Principles we follow

-The GOV.UK Design System helps teams that work on government services follow the Government Design Principles and GOV.UK Service Manual. This website also follows the style guide and content design guidance used by GOV.UK. +The GOV.UK Design System helps teams that work on government services follow the Government Design Principles and GOV.UK Service Manual. This website also follows the GOV.UK style guide and GOV.UK content design guidance.

diff --git a/src/privacy-policy.md b/src/privacy-policy.md index 6082402e78..4a82c95ec7 100644 --- a/src/privacy-policy.md +++ b/src/privacy-policy.md @@ -81,7 +81,7 @@ As part of [GOV.UK Design System](/) we share your personal data with data proce - software collaboration platforms when you share research, feedback or make a contribution - mailing list providers when you sign up to receive emails from us -- [support providers](https://www.gov.uk/government/publications/government-digital-service-user-support-privacy-notice/user-support-privacy-notice) when you contact us for assistance +- support providers when you contact us for assistance – [see the User support privacy notice](https://www.gov.uk/government/publications/government-digital-service-user-support-privacy-notice/user-support-privacy-notice) - web analytics services We will not: