ministryofjustice / operations-engineering

This repository is home to the Operations Engineering's tools and utilities for managing, monitoring, and optimising software development processes at the Ministry of Justice. • This repository is defined and managed in Terraform
https://user-guide.operations-engineering.service.justice.gov.uk/
MIT License
14 stars 5 forks source link

Update wording on "GitHub Organisation Invitation" for @justice.gov.uk user journey #4455

Closed AntonyBishop closed 5 months ago

AntonyBishop commented 5 months ago

From UR:

Not everyone is aware or has an understanding of Azure AD authentication

Content was confusing

Repetition of email address

Button label doesn't align to design and accessibility standards

Current page:

Image

Value

Reducing and simplifying content will help users understand what will happen next in this part of the journey

Functional Requirements:

  1. Work with User Researcher to update content on this page.

Acceptance Criteria:

  1. Content updated. UR and PM sign-off on page

Notes:

vijaykannan21 commented 5 months ago
AntonyBishop commented 5 months ago

Going to suggest a lot of changes on this page. I'm going to recommend the following based on the research.

  1. The page title ("GitHub Organisation Invitation") doesn't explain what this page is for. Please change to "Verify your work email address" because that is what we are asking users to do.

  2. Replace "To access the Ministry of Justice GitHub organisations you've selected, your email address tony@justice.gov.uk will be verified using Azure Active Directory (AD). This secure step is essential to confirm your identity and initiate the process of joining our GitHub organisations." with "This secure step is essential to confirm your identity and initiate the process of joining our GitHub organisations."

  3. Replace "By clicking the button below, you will be redirected to a secure Azure AD login page for authentication." with "By clicking the button below, you will be redirected to a secure sign-on page where you will be asked to confirm your Office 365 login details."

  4. Replace "After successfully authenticating with your @justice.gov.uk credentials, GitHub will send an invitation to tony@justice.gov.uk. You will need to accept this invitation to join the selected GitHub organisation." with "After successful verification a GitHub invitation will be sent to your work email address. You will need to accept this invitation to join the selected GitHub organisation."

  5. Replace button text "Authenticate tony@justice.go.uk" with "Verify".

  6. I think the last paragraph can stay as it is.

vijaykannan21 commented 5 months ago

https://github.com/ministryofjustice/operations-engineering-join-github/pull/187