From d62b1509d82a3bf758d22eee9d00b3b84f8353da Mon Sep 17 00:00:00 2001 From: AJ Date: Thu, 5 Jan 2023 09:22:28 +0000 Subject: [PATCH 1/4] New "Asking for feedback" page --- src/patterns/asking-for-feedback/index.md.njk | 146 ++++++++++++++++++ 1 file changed, 146 insertions(+) create mode 100644 src/patterns/asking-for-feedback/index.md.njk diff --git a/src/patterns/asking-for-feedback/index.md.njk b/src/patterns/asking-for-feedback/index.md.njk new file mode 100644 index 0000000000..627ebbc004 --- /dev/null +++ b/src/patterns/asking-for-feedback/index.md.njk @@ -0,0 +1,146 @@ +--- +title: Asking for feedback +description: A pattern for requesting feedback from users +section: Patterns +layout: layout-pane.njk +--- + +Nothing here is new. The guidance in this page is a collection of information from GOV.UK and in the Government service manual. This page brings that government advice together so it’s easier to find. + +## When to use this pattern + +Follow this advice when you want to collect feedback about your service or product. +Asking for feedback is a very important part of your service as we can learn and improve from it. You should usually do this from the very start of providing people a service or product. + +This guidance applies to all services and products, including those for: + +- the public on GOV.UK +- professional users +- staff use only + +Always follow this advice even if the way that you ask for feedback changes as your service grows. + +This advice is technology agnostic and it applies whether you build your own feedback form or purchase one off the shelf. + +### How it works + +When asking for feedback, you must consider: + +- accessibility +- how you will create an inclusive service – for example, how might you accidentally exclude someone from giving feedback? +- data protection +- design standards - making your page or form work and look the same way as every other page in your service +- Welsh language - if you offer a Welsh service +- security - you do not want someone to use your feedback page as an attack vector against the service, organisation, or Government + +You must be able to show these things: + +- in a Service Assessment +- at an internal review +- to someone else who asks how you're meeting your legal duties + +## Before you create a new feedback page or form + +For services on GOV.UK, you should check the [creating a standard feedback page on GOV.UK](https://www.gov.uk/service-manual/service-assessments/get-feedback-page). This is part of the process for getting your service onto a GOV domain. + +Services and products not on GOV.UK should consider the ‘standard’ feedback page first. + +You should only differ from that where you can demonstrate that it does not meet the users need, or you have a better way to meet them. + +For example, if you need to ask more specific questions so that users can answer the questions more successfully. + +### If you create your own form or page + +The following roles should be involved in creating new forms or pages: + +1. A user researcher should lead the discussion of ‘what we need to know’ and ‘information to collect’. They must make sure that we test it with real end users. +2. A content designer should lead the design of the form. +3. Use an interaction designer if you need to, to ensure existing proven patterns are used or to create new patterns. + +The rest of the development team should follow their same responsibilities they would for any other part of your service. For example, the feedback form must be accessibility tested for compliance. + +### How to decide between third party products or building your own + +Off-the shelf surveys and form products, for example Microsoft forms and Google forms, are often used for ‘collecting information’. + +The laws that apply to pages we build ourselves equally apply to third-party ones. For example, we are responsible for following data protection laws and the Equality Act 2010. . + +For example, we need to know: + +- that it’s secure – find out how to meet [point 9 of the service standard](https://www.gov.uk/service-manual/service-standard/point-9-create-a-secure-service) +- who has access to it +- where the people are who use it and the laws that apply there +- how data may be used by a third party. + +## Keep people’s data secure + +Government has a legal duty to protect user information. If we fail in that duty, we will undermine public trust in government services. + +The [Data Protection Act 2018](https://www.legislation.gov.uk/ukpga/2018/12/contents/enacted) controls how we use personal information in government. + +In your feedback form, you must [consider what information you collect from your users](https://www.gov.uk/service-manual/design/collecting-personal-information-from-users). + +You should always collect information anonymously when users are signed in. + +You must avoid collecting personal information about users if you do not intend to. For example, you may accidentally collect their name or email address if they are signed into a staff network. + +Where it would be useful to know who someone is, or to collect other personally identifying information you need to be clear about: + +- why you’re collecting it +- what you’re collecting +- how you'll use it +- who has access to it +- how long we’ll keep it +- that it will be secure +- how they can find out more or raise a concern or complaint + +[Find out more about the Data Protection Act and what it covers](https://www.gov.uk/data-protection) + +## Welsh language services + +Services in Welsh should provide feedback forms in Welsh. + +Check our [HM Land Registry Welsh Language Scheme](https://www.gov.uk/government/organisations/land-registry/about/welsh-language-scheme) if you are not sure if this applies to your service. + +If your service is being used by Welsh speaking people, you should do this as soon as possible. By public beta all parts of the service should be in Welsh including the feedback form. + +Follow our guidance for help with developing a Welsh version of your form. + +Contact Search for land and property information for information team to find out how they transformed their feedback form to get more useful results from their users. + +## Related links + +- [Get a feedback page on GOV.UK](https://www.gov.uk/service-manual/service-assessments/get-feedback-page) +- [How to structure forms](https://www.gov.uk/service-manual/design/form-structure) + +## Why you should follow this pattern advice + +It’s also part of your service under the law. For example, in the Equality Act 2010 we fall under the 'service provider' category. + +The rest of the team should consider this page as they would any other in the services, for example: + +- lawyers confirming compliance with all laws +- testers ensuring its technical accessibility +- software developers should ensure, for example it’s secure, is available, what happens if the service (or part of) is not available. +- user researchers and designers to ensure its usable and accessible (non-technical compliance + +The feedback form must be accessibility tested as part of the accessibility statement. + +## Accessibility and inclusivity + +Everything we provide in the operation of a service must be accessible and not discriminate. We are the ‘service provider’ in the Equality Act 2010, where it is illegal to discriminate against people with certain characteristics, for example race and disability. + +This applies to internal services as well as public and professional facing services. + +This applies to people using both the digital and non-digital parts of your service. + +How to: + +- [Make your service Inclusive (non-discriminating)](https://www.gov.uk/service-manual/design/making-your-service-more-inclusive) +- [Provide accessible services and assisted digital support](https://www.gov.uk/service-manual/helping-people-to-use-your-service) + +Does a service have to do it? (Welsh – think this lives n the Welsh guidance) + +Dunno - to write. +Ask a lawyer, ask them early on - e.g., early in Alpha. + \ No newline at end of file From 71f4814231d11cdbe884cdf611fbb4988cf1712b Mon Sep 17 00:00:00 2001 From: Andy Porter Date: Thu, 5 Jan 2023 13:04:46 +0000 Subject: [PATCH 2/4] remove unneccessary content --- src/patterns/asking-for-feedback/index.md.njk | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/src/patterns/asking-for-feedback/index.md.njk b/src/patterns/asking-for-feedback/index.md.njk index 627ebbc004..3124fcf85a 100644 --- a/src/patterns/asking-for-feedback/index.md.njk +++ b/src/patterns/asking-for-feedback/index.md.njk @@ -63,7 +63,7 @@ The rest of the development team should follow their same responsibilities they Off-the shelf surveys and form products, for example Microsoft forms and Google forms, are often used for ‘collecting information’. -The laws that apply to pages we build ourselves equally apply to third-party ones. For example, we are responsible for following data protection laws and the Equality Act 2010. . +The laws that apply to pages we build ourselves equally apply to third-party ones. For example, we are responsible for following data protection laws and the Equality Act 2010. For example, we need to know: @@ -139,8 +139,4 @@ How to: - [Make your service Inclusive (non-discriminating)](https://www.gov.uk/service-manual/design/making-your-service-more-inclusive) - [Provide accessible services and assisted digital support](https://www.gov.uk/service-manual/helping-people-to-use-your-service) -Does a service have to do it? (Welsh – think this lives n the Welsh guidance) - -Dunno - to write. -Ask a lawyer, ask them early on - e.g., early in Alpha. \ No newline at end of file From 2723d130effed29a31251e71e87763b841b7d9bb Mon Sep 17 00:00:00 2001 From: Andy Porter Date: Thu, 5 Jan 2023 14:06:58 +0000 Subject: [PATCH 3/4] improve wording on our duty on third parties, and couple other minor tweaks --- src/patterns/asking-for-feedback/index.md.njk | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/src/patterns/asking-for-feedback/index.md.njk b/src/patterns/asking-for-feedback/index.md.njk index 3124fcf85a..4f87e13e46 100644 --- a/src/patterns/asking-for-feedback/index.md.njk +++ b/src/patterns/asking-for-feedback/index.md.njk @@ -5,11 +5,12 @@ section: Patterns layout: layout-pane.njk --- -Nothing here is new. The guidance in this page is a collection of information from GOV.UK and in the Government service manual. This page brings that government advice together so it’s easier to find. +The guidance in this page is a collection of information from GOV.UK and in the Government service manual. This page brings that government advice together so it’s easier to find and understand. ## When to use this pattern Follow this advice when you want to collect feedback about your service or product. + Asking for feedback is a very important part of your service as we can learn and improve from it. You should usually do this from the very start of providing people a service or product. This guidance applies to all services and products, including those for: @@ -20,7 +21,7 @@ This guidance applies to all services and products, including those for: Always follow this advice even if the way that you ask for feedback changes as your service grows. -This advice is technology agnostic and it applies whether you build your own feedback form or purchase one off the shelf. +This advice is technology agnostic and it applies whether you build your own feedback form, purchase one off-the-shelf, or use a third party tool. ### How it works @@ -53,7 +54,7 @@ For example, if you need to ask more specific questions so that users can answer The following roles should be involved in creating new forms or pages: -1. A user researcher should lead the discussion of ‘what we need to know’ and ‘information to collect’. They must make sure that we test it with real end users. +1. A user researcher should lead the discussion of ‘what we need to know’ and ‘information to collect’. They must make sure that it is tested with real end users. 2. A content designer should lead the design of the form. 3. Use an interaction designer if you need to, to ensure existing proven patterns are used or to create new patterns. @@ -61,16 +62,19 @@ The rest of the development team should follow their same responsibilities they ### How to decide between third party products or building your own -Off-the shelf surveys and form products, for example Microsoft forms and Google forms, are often used for ‘collecting information’. +Off-the-shelf surveys and form products, for example Microsoft forms and Google forms, are often used for collecting information. + +The laws that apply to feedback pages we code ourselves apply equally to those we choose to include from third parties. As the operator of the service, we are responsible for those third parties compliance with the law. For example the data protection laws and the Equality Act 2010. -The laws that apply to pages we build ourselves equally apply to third-party ones. For example, we are responsible for following data protection laws and the Equality Act 2010. +If outsourcing data collection and processing, you will probably need a lawyer to help understand the data protection laws in the UK and assess the potential third parties’ privacy and security procedures. For example, we need to know: - that it’s secure – find out how to meet [point 9 of the service standard](https://www.gov.uk/service-manual/service-standard/point-9-create-a-secure-service) - who has access to it - where the people are who use it and the laws that apply there -- how data may be used by a third party. +- what data is being collected by the third party (which is likely to be more than the questions we add to their tool) +- how data may be used by a third party ## Keep people’s data secure From a42370e8f291f867d1e5bfe4a73fa2e8b0ef8ff3 Mon Sep 17 00:00:00 2001 From: AJ Date: Fri, 6 Jan 2023 15:51:03 +0000 Subject: [PATCH 4/4] Removed unnecessary paragraphs --- src/patterns/asking-for-feedback/index.md.njk | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/src/patterns/asking-for-feedback/index.md.njk b/src/patterns/asking-for-feedback/index.md.njk index 4f87e13e46..75922bdc5c 100644 --- a/src/patterns/asking-for-feedback/index.md.njk +++ b/src/patterns/asking-for-feedback/index.md.njk @@ -42,7 +42,7 @@ You must be able to show these things: ## Before you create a new feedback page or form -For services on GOV.UK, you should check the [creating a standard feedback page on GOV.UK](https://www.gov.uk/service-manual/service-assessments/get-feedback-page). This is part of the process for getting your service onto a GOV domain. +For services on GOV.UK, you should check the [creating a standard feedback page on GOV.UK](https://www.gov.uk/service-manual/service-assessments/get-feedback-page). This is part of the process for getting your service onto a GOV domain. Services and products not on GOV.UK should consider the ‘standard’ feedback page first. @@ -66,8 +66,6 @@ Off-the-shelf surveys and form products, for example Microsoft forms and Google The laws that apply to feedback pages we code ourselves apply equally to those we choose to include from third parties. As the operator of the service, we are responsible for those third parties compliance with the law. For example the data protection laws and the Equality Act 2010. -If outsourcing data collection and processing, you will probably need a lawyer to help understand the data protection laws in the UK and assess the potential third parties’ privacy and security procedures. - For example, we need to know: - that it’s secure – find out how to meet [point 9 of the service standard](https://www.gov.uk/service-manual/service-standard/point-9-create-a-secure-service) @@ -110,8 +108,6 @@ If your service is being used by Welsh speaking people, you should do this as so Follow our guidance for help with developing a Welsh version of your form. -Contact Search for land and property information for information team to find out how they transformed their feedback form to get more useful results from their users. - ## Related links - [Get a feedback page on GOV.UK](https://www.gov.uk/service-manual/service-assessments/get-feedback-page) @@ -132,7 +128,7 @@ The feedback form must be accessibility tested as part of the accessibility stat ## Accessibility and inclusivity -Everything we provide in the operation of a service must be accessible and not discriminate. We are the ‘service provider’ in the Equality Act 2010, where it is illegal to discriminate against people with certain characteristics, for example race and disability. +Everything we provide in the operation of a service must be accessible and not discriminate. We are the ‘service provider’ in the Equality Act 2010, where it is illegal to discriminate against people with certain characteristics, for example race and disability. This applies to internal services as well as public and professional facing services.