alphagov
Review the automated and manual migration processes
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
- [ ] We have reviewed the automated process
- [ ] We have reviewed the manual process
- [ ] We agree on any changes
- [ ] We know what needs to be documented
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
@BenSurgisonGDS and I started looking at this today, some notes: https://docs.google.com/document/d/1nxIiYASTqo2j7bAssAgi4aIMiXVElJybe01ZwLaz0JA/edit
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.
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.
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.
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.
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.