From bd19f1d0c70ca24148d25ade95f8b01dae3e3c43 Mon Sep 17 00:00:00 2001
From: Charlotte Downs <56260216+CharlotteDowns@users.noreply.github.com>
Date: Wed, 9 Aug 2023 13:22:58 +0100
Subject: [PATCH] Add Calvin's suggestion

Co-authored-by: Calvin Lau <77630796+calvin-lau-sig7@users.noreply.github.com>
---
 src/patterns/passwords/index.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/patterns/passwords/index.md b/src/patterns/passwords/index.md
index 738f4579e5..f13ba64a73 100644
--- a/src/patterns/passwords/index.md
+++ b/src/patterns/passwords/index.md
@@ -70,10 +70,11 @@ To help users meet your password constraints and prevent mistyped passwords, you
 - make them enter their password twice and automatically compare them
 
 #### Showing and hiding passwords
-One common method for helping users type passwords is a show/hide button near the password input. When the password is hidden, the button will change the input styling to 'show' the password. When the password is visible, the button will 'hide' the password again.
+It's common for services to help users type passwords with a '[show password](https://github.com/alphagov/govuk-design-system-backlog/issues/240)' button to let users see their password if they want to.
 
 When there are two or more password fields on a page, the 'show' and 'hide' labels for each password input must be different.
-For example, you can label the input "Password" as "show first password" and label the second input "Re-enter password" as "show second re-entered password".
+
+For example, you can label the input "Password" as "show password" and label the second input "Re-enter password" as "show re-entered password".
 
 ### Allow users to paste their password