Merge pull request #130 from alphagov/2024-01-17-New-features-README-…

…layout-and-content

2024 01 17 new features readme layout and content

design/README.md

@@ -0,0 +1,22 @@
+# Design documentation
+
+We use this part of the GOV.UK Forms repo to record design work and decisions we’ve made.  
+
+You can explore our initial versions of GOV.UK Forms, the prototypes we tested, and new features as they’ve been iterated and adapted based on user research, data and new design patterns.  
+
+## Prototype version history
+
+At the start of alpha we explored the wider product, focusing on quick iterations across whole journeys. This helped us get a clearer picture of our minimum viable product (MVP) so we could baseline where we wanted to start work from.  
+
+* [Prototype version 1](prototype-version-1)
+* [Prototype version 2](prototype-version-2)
+* [Prototype version 3](prototype-version-3)
+* [Prototype version 4](prototype-version-4)
+* [Prototype version 5](prototype-version-5)
+* [Prototype version 6](prototype-version-6)
+
+## Features
+
+Once we had a baseline that worked for form creators we shifted focus onto key features. The aim was to help align GOV.UK Forms with the key functionality that would help form creators make more of their forms with our product. We used the team’s analysis of feature coverage of forms across GOV.UK to help us priorititse this work. 
+
+You can explore the [features](features) as we’ve designed them and see how they’ve been iterated based on user research and feedback through private beta and ‘early access’. ('Early access' is the period in which we’re encouraging people to try out GOV.UK Forms to see if it’s suitable for them). 

design/features/README.md

@@ -1,7 +1,30 @@
 # Features
 
-Features we have designed and developed into the product directly, rather than the prototype.
+We use this area to record design work and decisions made, and any iterations made to improve usability for form creators and form fillers.  
 
-## [Live and draft](/design/features/live-draft/README.md)
-The ability to make a draft of a live form to prepare changes to it. You can then make all the changes live at the same time, and at an appropriate time.
+## Explore the features we’ve designed  
+
+### [Confirm that a form’s been submitted (form fillers)](confirmation-email-for-form-fillers)  
+This feature introduces new functionality to the form filler’s journey, allowing them to request an email confirming that they’ve successfully submitted a form.
+
+### [Add guidance to help people answer the question (‘detailed guidance’)](detailed-guidance)  
+This feature introduces new functionality to the form building tool, allowing form creators to add more complex help text to a question page. This ‘guidance’ text will appear above the question, on the same page.
+
+### [‘Early access’ journey](early-access)  
+This journey is designed to allow people to create a trial account and request an upgrade to an editor account - so they can make live forms to be published on GOV.UK.
+
+### [Editing pages when looking at a preview of a form](editing-drafts)  
+This feature introduces functionality in the form building tool to help form creators return to edit their questions more quickly when previewing the form as if they’re someone who’s filling it in. It introduces a clearer, simpler route for form creators to navigate between previewing and editing their form.
+
+### [Metrics for form creators](form-metrics)  
+This feature introduces new functionality to the form building tool to allow form creators to see how their form is performing. We’ll be starting with a minimum offering of: number of forms started, number of forms submitted, and completion rate.
+
+### [Live and draft](live-draft)  
+This feature introduces the ability to make a draft of a live form so that you can prepare changes to it. You can then make all the changes live at the same time, when appropriate.
+
+### [Previewing a question](previewing-a-question)  
+This feature introduces a clear and quick way to help form creators understand what an answer type will look like and how it’ll be formatted alongside other content they’ve added - including hint text and additional guidance.
+
+### [Simple routing logic (skip questions)](routing)  
+This feature introduces new functionality to the form building tool to help form creators create simple skip logic for questions. This means you can skip someone to a later question in a form based on their response to a question where they have to select one answer from a list.
 

design/features/confirmation-email-for-form-fillers/README.md

@@ -23,7 +23,7 @@ ___
 
 ## What
 
-This feature introduces new functionality to the form filler's journey, allowing them to request an email confirming that they've successfully submitted a form. 
+This feature introduces new functionality to the form filler’s journey, allowing them to request an email confirming that they’ve successfully submitted a form.
 
 ### User stories
 

design/features/detailed-guidance/README.md

@@ -23,7 +23,7 @@ ___
 
 ## What
 
-This feature introduces new functionality to the form building tool to allow form creators to add more complex help text to a question page. This 'guidance' text will appear above the question, on the same page.  
+This feature introduces new functionality to the form building tool, allowing form creators to add more complex help text to a question page. This ‘guidance’ text will appear above the question, on the same page.
 
 This is considered the best way to introduce complex information when most (if not all) form fillers will need to read that information in order to complete a single question.  
 

design/features/early-access/README.md

@@ -1,4 +1,4 @@
-# Early access journey
+# ‘Early access’ journey
 
 ## Status
 
@@ -11,7 +11,7 @@ ___
 
 ## Contents
 
-- [Early access journey](#early-access-journey)
+- [‘Early access’ journey](#early-access-journey)
   - [Status](#status)
   - [What](#what)
   - [Problems we tried to solve](#problems-we-tried-to-solve)
@@ -24,7 +24,7 @@ ___
 <br>
 
 ## What
-This journey is designed to allow people to create a trial account and request an upgrade to an editor account - so they can make live forms to be published on GOV.UK. 
+This journey is designed to allow people to create a trial account and request an upgrade to an editor account - so they can make live forms to be published on GOV.UK.
 
 <br>
 

design/features/editing-drafts/README.md

@@ -28,7 +28,7 @@ ___
 
 ## What
 
-This feature introduces functionality in the form building tool to help form creators return to edit their questions more quickly when previewing the form as though they're someone who's filling it in. It introduces a clearer, simpler route for form creators to navigate between previewing and editing their form.  
+This feature introduces functionality in the form building tool to help form creators return to edit their questions more quickly when previewing the form as if they’re someone who’s filling it in. It introduces a clearer, simpler route for form creators to navigate between previewing and editing their form. 
 
 <br>
 

design/features/form-metrics/README.md

@@ -23,7 +23,7 @@ ___
 
 ## What
 
-This feature introduces new functionality to the form building tool to allow form creators to see how their form is performing. Initially we’ll be starting with a minimum offering of: number of started forms, number of submitted forms, and completion rate.
+This feature introduces new functionality to the form building tool to allow form creators to see how their form is performing. We’ll be starting with a minimum offering of: number of forms started, number of forms submitted, and completion rate.
 
 This information should cover at least a week of data collected. We’ll look to improve this offering over time and will investigate introducing filters to help form creators adapt data for their needs.  
 

design/features/live-draft/README.md

@@ -1,5 +1,6 @@
 ## Live and draft
-The ability to make a draft of a live form to prepare changes to it. You can then make all the changes live at the same time, and at an appropriate time.
+
+This feature introduces the ability to make a draft of a live form so that you can prepare changes to it. You can then make all the changes live at the same time, when appropriate.
 
 ### Problems we tried to solve
 

design/features/previewing-a-question/README.md

@@ -23,7 +23,7 @@ ___
 
 ## What
 
-This feature introduces a clear and quick way to help form creators understand what an answer type will look like and how it’ll be formatted alongside other content they have added, including hint text and additional guidance.  
+This feature introduces a clear and quick way to help form creators understand what an answer type will look like and how it’ll be formatted alongside other content they’ve added - including hint text and additional guidance.  
 
 It is designed to be an optional journey for form creators who are unsure about what an answer type may look like, while giving them a quick idea of the overall layout as presented to form fillers.  
 

design/features/routing/README.md

@@ -24,7 +24,7 @@ ___
 
 ## What
 
-This feature introduces new functionality to the form building tool to help form creators create simple skip logic for questions. This means that people completing a form only need to be asked relevant questions based on a previously given answer.
+This feature introduces new functionality to the form building tool to help form creators create simple skip logic for questions. This means you can skip someone to a later question in a form based on their response to a question where they have to select one answer from a list.
 
 ### User stories
 

design/prototype-version-3/prototype-tested.md → design/prototype-version-3/README.md

@@ -277,4 +277,4 @@ ___
 
 <br>
 
-[Back to the top](#prototype-version-3)
+[Back to the top](#prototype-version-3)

design/prototype-version-4/prototype-tested.md → design/prototype-version-4/README.md

@@ -248,4 +248,4 @@ ___
 
 <br>
 
-[Back to the top](#prototype-version-4)
+[Back to the top](#prototype-version-4)

design/prototype-version-5/prototype-tested.md → design/prototype-version-5/README.md

@@ -237,4 +237,4 @@ ___
 
 <br>
 
-[Back to the top](#prototype-version-5)
+[Back to the top](#prototype-version-5)

design/prototype-version-6/prototype-tested.md → design/prototype-version-6/README.md

@@ -250,4 +250,4 @@ ___
 
 <br>
 
-[Back to the top](#prototype-version-6)
+[Back to the top](#prototype-version-6)