Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
112 commits
Select commit Hold shift + click to select a range
ec26f7f
Update retention time on sequence diagram
stephencdaly Feb 3, 2026
f2e961d
Merge pull request #243 from alphagov/update-retention-time-on-sequen…
stephencdaly Feb 3, 2026
64201e3
Update the submission email sequence diagram
stephencdaly Feb 6, 2026
40f9c03
Update forms-runner class diagram
stephencdaly Feb 9, 2026
ae72f4b
Merge pull request #244 from alphagov/update-sequence-diagram-to-incl…
stephencdaly Feb 9, 2026
4e82735
Create screenshots folder for V2 and README file
christophercameron-ixd Feb 23, 2026
7f7df29
Create version-2 initial document structure
christophercameron-ixd Feb 23, 2026
9faa961
Added screenshots with some placeholders
christophercameron-ixd Feb 23, 2026
1a02c1c
Initial few screenshots added
christophercameron-ixd Feb 23, 2026
8540370
Added another screenshot and caption text for each screenshot
christophercameron-ixd Feb 23, 2026
4979c2e
Deleting a Welsh version screenshots
christophercameron-ixd Feb 23, 2026
2a6fd50
Added deleted version task list page
christophercameron-ixd Feb 23, 2026
0f647f6
Form filler preview where Welsh content hasn’t been added yet
christophercameron-ixd Feb 24, 2026
33ff3ea
Update README.md
hannahkc Feb 24, 2026
e32da87
Merge pull request #245 from govuk-forms/hannahkc-readme-link-to-prod…
hannahkc Feb 24, 2026
e54392c
Add a Welsh version screens for full English form
christophercameron-ixd Feb 24, 2026
275e194
Updated screenshots to img tags to override the width
christophercameron-ixd Feb 24, 2026
cf2a095
Added Welsh saved task list screens
christophercameron-ixd Feb 24, 2026
3ea2ebd
Added make your form live screens - these should be updated
christophercameron-ixd Feb 24, 2026
2caf872
Added things to note section to explain what this version misses
christophercameron-ixd Feb 25, 2026
20299ed
Removed unchanged make form live screens
christophercameron-ixd Feb 25, 2026
e4240da
Form filler preview Welsh screenshots added
christophercameron-ixd Feb 25, 2026
2faf100
Create a form - task list description
christophercameron-ixd Feb 26, 2026
61f1e21
Formatting fix for inset of Create a form - task list
christophercameron-ixd Feb 26, 2026
1ddee7e
Add a Welsh version of your form - new form without any content descr…
christophercameron-ixd Feb 26, 2026
d911be9
Update version-2.md
christophercameron-ixd Feb 26, 2026
49deaf3
Trying to fix formatting
christophercameron-ixd Feb 26, 2026
660fbee
Update version-2.md
christophercameron-ixd Feb 26, 2026
03f56c2
Formatting changes and description added to delete screens
christophercameron-ixd Feb 26, 2026
f5ac6a5
Add a Welsh version of your form - empty English form description upd…
christophercameron-ixd Feb 27, 2026
fabf095
Welsh translations page description updated
christophercameron-ixd Feb 27, 2026
70b97de
Update preview format
christophercameron-ixd Feb 27, 2026
70f90a7
Some typo and clarity tweaks
hannahkc Mar 2, 2026
ee6e35f
Removed duplicate for
christophercameron-ixd Mar 2, 2026
a0fe6f6
Added Welsh version link and outline
christophercameron-ixd Mar 2, 2026
cd12c08
Update README.md
christophercameron-ixd Mar 2, 2026
02bf710
Merge pull request #246 from govuk-forms/2026-02-23-welsh-version-2-f…
christophercameron-ixd Mar 2, 2026
8c84aef
Create version-4-daily-batch-submissions.md
christophercameron-ixd Mar 16, 2026
e47479a
Create README.md
christophercameron-ixd Mar 16, 2026
a59273c
Add files via upload
christophercameron-ixd Mar 16, 2026
800d1d4
Added screenshots
christophercameron-ixd Mar 16, 2026
b32ca9c
Added example email screenshots
christophercameron-ixd Mar 16, 2026
3a71ce3
Added daily submission example emails
christophercameron-ixd Mar 16, 2026
31fdf8b
Task list write up
christophercameron-ixd Mar 18, 2026
1d5e59d
Get a daily CSV of the previous day’s completed forms write up
christophercameron-ixd Mar 18, 2026
cdb6aa9
How you get completed forms write up
christophercameron-ixd Mar 18, 2026
20b9656
Added updated email screenshots
christophercameron-ixd Mar 19, 2026
c3a0937
Delete design/features/getting-completed-form-submissions/version-4-d…
christophercameron-ixd Mar 19, 2026
34d9f87
Fixed live email
christophercameron-ixd Mar 19, 2026
6ff64b4
Trying to add live email... again
christophercameron-ixd Mar 19, 2026
67bc328
Delete design/features/getting-completed-form-submissions/version-4-d…
christophercameron-ixd Mar 19, 2026
af7e943
Daily collated email live version write up
christophercameron-ixd Mar 19, 2026
a3cefcd
Collation email preview write up
christophercameron-ixd Mar 19, 2026
3be0199
Added link to mural board
christophercameron-ixd Mar 19, 2026
a972ac5
Added content documentation
christophercameron-ixd Mar 19, 2026
7581007
Small content tweaks of version-4-daily-batch-submissions.md
hannahkc Mar 23, 2026
7541d9b
Add links to 2 latest iterations to form submissions README
hannahkc Mar 24, 2026
f2682e0
Merge pull request #247 from govuk-forms/2026-03-16-daily-batch-submi…
christophercameron-ixd Mar 24, 2026
c986a61
Fix typo
hannahkc Mar 25, 2026
f65f96e
Update alphagov references to govuk-forms
cadmiumcat Mar 30, 2026
432b9b6
Create folder for screenshots
hannahkc Mar 30, 2026
1bb0669
Add screenshot files
hannahkc Mar 30, 2026
c4f5ad5
Create version-5-weekly-batch-submissions.md
hannahkc Mar 30, 2026
0360d8f
Changed comma to full stop at end of sentence
C-Harry Mar 30, 2026
fba0e69
Update version-5-weekly-batch-submissions.md
hannahkc Mar 30, 2026
b271fb0
Update version-5-weekly-batch-submissions.md
hannahkc Mar 30, 2026
171ecea
fixed typo
hannahkc Mar 30, 2026
91a1115
Merge pull request #250 from govuk-forms/hannahkc-weekly-batches
hannahkc Mar 30, 2026
9e29751
Merge pull request #249 from govuk-forms/trasfer-forms-deploy-repo
cadmiumcat Apr 1, 2026
91970ad
New design feature folder for adding an answer for 'none of the above'
C-Harry Apr 1, 2026
484266f
Delete design/features/add-answer-for-none-of-the-above
C-Harry Apr 1, 2026
5338eef
Create add-answer-for-none-of-the-above documentation folder under de…
C-Harry Apr 1, 2026
421d3bc
Delete design/features/add-answer-for-none-of-the-above
C-Harry Apr 1, 2026
de9c17a
Create README
C-Harry Apr 1, 2026
dd530ed
Add README for 'none of the above' answer feature
C-Harry Apr 1, 2026
cedb474
Create README.md
C-Harry Apr 1, 2026
b1b634f
Added markdown to new README file that has correct file extension
C-Harry Apr 1, 2026
72a9ba5
Delete old README (no .md extension)
C-Harry Apr 1, 2026
3148357
Delete old README (no .md extension)
C-Harry Apr 1, 2026
763cd8f
Create version-1.md
C-Harry Apr 1, 2026
7328df5
Create folder for screenshots
C-Harry Apr 1, 2026
329b115
Changing the screenshots folder file name
C-Harry Apr 1, 2026
dd616fa
Adding description for screenshots folder
C-Harry Apr 1, 2026
fa8ab18
Added screenshot files
C-Harry Apr 7, 2026
f41520e
Uploading a new screenshot to replace old one
C-Harry Apr 7, 2026
4f326ff
Uploading correct replacement image
C-Harry Apr 7, 2026
1950f60
Uploading replacement screenshot 004 again
C-Harry Apr 7, 2026
11e4a74
Added content documenting 'none of the above' answers
C-Harry Apr 8, 2026
375908d
Added new anchor link and tried linking to image
C-Harry Apr 8, 2026
1c87998
Fix screenshot path for first image link
C-Harry Apr 8, 2026
fec482f
Try to link screenshot again
C-Harry Apr 8, 2026
84819a4
Trying to correct screenshot link again
C-Harry Apr 8, 2026
b5dba94
Hannah testing
hannahkc Apr 8, 2026
953534d
New image links added, using HTML
C-Harry Apr 8, 2026
6755ab3
Added extra blank line under some H3s
C-Harry Apr 8, 2026
2d1155d
Adjusted image widths as 400 was rendering rather small
C-Harry Apr 8, 2026
e58a09e
Adjusted image widths to 500
C-Harry Apr 8, 2026
4a4e03a
Apply suggestion from @christophercameron-ixd
C-Harry Apr 13, 2026
79dbd7e
Apply suggestion from @hannahkc
C-Harry Apr 13, 2026
bfc5c95
Amend journey description
C-Harry Apr 13, 2026
c8569a7
Added new sentence for clarification
C-Harry Apr 13, 2026
e9bc384
Added hint text description
C-Harry Apr 13, 2026
5975abc
Added full stop
C-Harry Apr 13, 2026
a788ebf
Apply suggestion from @hannahkc
C-Harry Apr 13, 2026
055fbd5
Added double spacing at end of each line
C-Harry Apr 13, 2026
0806869
Added missing H1
C-Harry Apr 13, 2026
c7c95a8
Approved so now merging
C-Harry Apr 15, 2026
2718f2f
Add Welsh translation state diagram
thomasiles Apr 15, 2026
94e27cf
Add ADR049: Remove user research environment
theseanything Apr 16, 2026
53eddce
Update diagrams/state-diagrams/welsh-translation-states-and-fields.md
thomasiles Apr 24, 2026
7b75ab0
Merge pull request #253 from govuk-forms/theseanything/adr-049
theseanything Apr 27, 2026
5aae22b
Merge pull request #252 from govuk-forms/add-welsh-state-diagram
thomasiles Apr 27, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# PR Checklist

- [ ] If you are proposing a new decision record document, used the right template for that
- ([ADR](https://github.com/alphagov/forms/blob/main/ADR/ADRXXX-architecture-decision-record-template.md), [decision-record](https://github.com/alphagov/forms/blob/main/decision-record/DRXXX-decision-record-template.md), engagement, [research](https://github.com/alphagov/forms/blob/main/research/YYYY-MM-DD-template.md))
- ([ADR](https://github.com/govuk-forms/forms/blob/main/ADR/ADRXXX-architecture-decision-record-template.md), [decision-record](https://github.com/govuk-forms/forms/blob/main/decision-record/DRXXX-decision-record-template.md), engagement, [research](https://github.com/govuk-forms/forms/blob/main/research/YYYY-MM-DD-template.md))
- [ ] Set yourself as the Assignee
- [ ] Tag anyone you would like to review, or @forms-design or @forms-devs
- [ ] Fill in the template below
Expand Down
36 changes: 36 additions & 0 deletions ADR/ADR049-remove-user-research-environment.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
ADR049: Remove user research environment

Date: 2026-04-16

## Status

Accepted

## Context

We run a separate user research (UR) environment: a copy of GOV.UK Forms in its own AWS account. It used to cost about $850 per month; after reducing database spend it now costs about $350 per month ($4,200 per year). There is little further scope to reduce costs without removing parts of the infrastructure, which creates overhead before we can start using it.

We have not used it in the last 12 months, and there are no plans to use it in the short term.

We have also built pull request (PR) preview environments, which provide a convenient way to see and interact with changes before they are merged.

The main benefits of the UR environment were that it was isolated from other environments, could be kept stable (protected from change) while we conducted user research, and allowed testing of larger changes (e.g. deploying multiple applications or changes to infrastructure).

We also have dev environment which is seperate to our deployment pipeline (i.e. not staging and production). It could be used in lieu of the UR environment.

## Decision

We will remove the user research environment and its AWS infrastructure.

The ongoing cost in money, maintenance time, and operational overhead is now disproportionate to the value it delivers, especially given recent usage.

If and when we need we could do the following:
- freeze deployments to the dev environment when we need a stable environment for research
- use PR preview environments for smaller, single app changes
- improve preview environments to support more complex multi-app or infrastructure changes where needed

## Consequences

- Saves about $350 per month ($4,200 per year).
- Reduces operational overhead and platform complexity.
- Means some larger changes will need more coordination to run UR in dev, or further investment in preview environments.
20 changes: 12 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# GOV.UK Forms

GOV.UK Forms is a platform that makes it easy for government service teams to create accessible online forms. You can find out more about it on our product site: [www.gov.uk/forms](https://www.forms.service.gov.uk/)

## This repository

We record our work and decisions in this repo.

You can find:
Expand All @@ -10,18 +14,18 @@ You can find:
- user research findings in [research/](research/)
- documentation of our designs in [design/](design/)

## Our repositories
## Our other repositories

You can find our code in the following repositories:
- [forms-admin](https://github.com/alphagov/forms-admin) - our application for building forms.
- [forms-runner](https://github.com/alphagov/forms-runner) - our application for hosting forms, so that they can be filled in by members of the public.
- [forms-e2e-tests](https://github.com/alphagov/forms-e2e-tests) - end-to-end tests for the service.
- [forms-product-page](https://github.com/alphagov/forms-product-page) - our product pages, as seen at [https://forms.service.gov.uk](https://forms.service.gov.uk)
- [forms-prototypes](https://github.com/alphagov/forms-prototypes) - our prototypes, used for user research and design exploration.
- [govuk-forms-markdown](https://github.com/alphagov/govuk-forms-markdown) - our gem for rendering the limited subset of markdown we support.
- [forms-admin](https://github.com/govuk-forms/forms-admin) - our application for building forms.
- [forms-runner](https://github.com/govuk-forms/forms-runner) - our application for hosting forms, so that they can be filled in by members of the public.
- [forms-e2e-tests](https://github.com/govuk-forms/forms-e2e-tests) - end-to-end tests for the service.
- [forms-product-page](https://github.com/govuk-forms/forms-product-page) - our product pages, as seen at [https://forms.service.gov.uk](https://forms.service.gov.uk)
- [forms-prototypes](https://github.com/govuk-forms/forms-prototypes) - our prototypes, used for user research and design exploration.
- [govuk-forms-markdown](https://github.com/govuk-forms/govuk-forms-markdown) - our gem for rendering the limited subset of markdown we support.

We also have:
- [a private wiki](https://github.com/alphagov/forms-team/wiki) for team documentation (set-up, onboarding etc)
- [a private wiki](https://github.com/govuk-forms/forms-team/wiki) for team documentation (set-up, onboarding etc)

## License

Expand Down
2 changes: 1 addition & 1 deletion decision-record/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Proposing and reviewing decisions requires an understanding of the GitHub and [p

## Reviewing a decision

1. Find the decision record in the list of [pull requests](https://github.com/alphagov/forms/pulls)
1. Find the decision record in the list of [pull requests](https://github.com/govuk-forms/forms/pulls)
2. Add a comment and / or approve the pull request

## Approving / superseding / rejecting a decision
Expand Down
6 changes: 5 additions & 1 deletion design/features/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,4 +44,8 @@ Asks form creator users for consent to send an email to them about user research
Allows form creators to create 2 branches of questions or to skip someone to a later question, or an exit page, based on an answer to a radio question.

### [User management journey](user-management)
Gives organisations more control over who can create forms and who can make them live.
Gives organisations more control over who can create forms and who can make them live.

### [Welsh version pages](welsh-version)
Allows form creators to add a Welsh version of their form as part of their English version.

24 changes: 24 additions & 0 deletions design/features/add-answer-for-none-of-the-above/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# Let people add an answer if ‘none of the above’ is selected

## Contents

- [What](#what)
- [Why](#why)

---

## What

This feature lets form creators ask form fillers to enter an answer if they’ve selected ‘none of the above’ from a selection list question.

Form creators can choose whether it’s mandatory or optional for form fillers to provide an answer if they’ve selected ‘none of the above’.

## Why

It’s a requested feature that people expect a form builder to have. We expect it to increase the number of forms and submissions, and to have a positive impact on user satisfaction.

At least 5 departments had expressed interest in this feature. We’d also received at least 5 anonymous feedback tickets about it from our feedback link by the time we started the work.

The need for this feature came up as part of the ‘select from a long list’ work, as we were adding a ‘None of the above’ option to autocomplete.

Usability testing suggested that some people expected to be able to add an option for ‘Other’ followed by a text box where they could enter more information.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
This folder contains screenshots for the feature that lets people add another answer if they've selected 'none of the above' for a selection question
Loading
Loading