Review the automated and manual migration processes

[joelanman]

What

As a team, review the automated and manual migration processes

Why

• So we have a shared understanding
• Make any changes we agree on
• Understand what needs to be documented
• Help users in support

Who needs to work on this

• developers
• interaction designer
• content designer

Who needs to review this

• developers
• interaction designer
• content designer

Done when

• [x] We have reviewed the manual process
• [x] We have reviewed the automated process
• [x] We agree on any changes
• [ ] We know what needs to be documented

[Izabela-16]

Any changes will go to the separate card

[Izabela-16]

Prototype test cases @joelanman to link them to the ticket

[joelanman]

here's some, will add more when I find them

• https://github.com/alphagov/digital-identity-prototype
• https://github.com/alphagov/forms-prototypes
• https://github.com/alphagov/col-prototypes
• https://github.com/ministryofjustice/hmpps-activity-management-prototype
• https://github.com/ministryofjustice/approved-premises-prototype
• https://github.com/DFE-Digital/fh-family-experience-prototype

A good way to find them is to go to dept github accounts and search 'prototype' in their repos

[lfdebrux]

@BenSurgisonGDS and I started looking at this today, some notes: https://docs.google.com/document/d/1nxIiYASTqo2j7bAssAgi4aIMiXVElJybe01ZwLaz0JA/edit

[lfdebrux]

I've finished reviewing and documenting the process needed to migrate a prototype, I've documented in the first section of https://docs.google.com/document/d/1nxIiYASTqo2j7bAssAgi4aIMiXVElJybe01ZwLaz0JA.

@nataliecarey @BenSurgisonGDS please take a look and let me know if I've missed any steps.

I've deliberately kept the content detailed but succint, as there are a lot of steps. This means that only an expert user would be able to understand the steps, but I've kept the target audience as being team members. I don't think we'd be able to write content that would explain each step in a way that fit with the needs of a plurality of our users.

[lfdebrux]

In terms of reviewing the automated process, we're part way there. @BenSurgisonGDS and I understand what it is supposed to be doing, and we've shared what we've learnt with @joelanman. Whats outstanding is: @BenSurgisonGDS is continuing to add tests to make sure it is actually doing what it is supposed to; and I would like it if we had a shared understanding and agreement among the team of what the automated process does and doesn't do.

[lfdebrux]

We want to get some quantitive data before we make decisions on further changes to the automated process (see ticket #1720), so I'm putting this ticket in blocked until that work has been completed.

[lfdebrux]

After looking at the automated migration script I have some proposals for changes:

• https://github.com/alphagov/govuk-prototype-kit/issues/1713
• https://github.com/alphagov/govuk-prototype-kit/issues/1728
• https://github.com/alphagov/govuk-prototype-kit/issues/1729

We might make more as a result of reviewing the output of #1720.

[lfdebrux]

We've agreed to move the above tickets https://github.com/alphagov/govuk-prototype-kit/issues/1634#issuecomment-1294863003 into the sprint backlog, but that we don't think further changes are probably needed right now.