Skip to content

Commit

Permalink
all links iterated for style
Browse files Browse the repository at this point in the history
  • Loading branch information
@kerryalyons
kerryalyons committed May 28, 2024
1 parent 7c65867 commit 1350783
Show file tree
Hide file tree
Showing 18 changed files with 131 additions and 131 deletions.
6 changes: 3 additions & 3 deletions app/views/accessibility-statement.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
{% set pageName = "Accessibility statement" %}
{% set pageDescription = "Accessibility statement for the user centred design manual in the Department for Education." %}
{% set selectedNav = "" %}
{% set lastUpdated = "April 2023 "%}
{% set lastUpdated = "May 2024 "%}

{% block beforeContent %}{% endblock %}

Expand Down Expand Up @@ -66,9 +66,9 @@ <h2>Compliance status</h2>

<h2>Preparation of this accessibility statement</h2>

<p>This statement was prepared on 7 September 2022. It was last reviewed on 27 April 2023.</p>
<p>This statement was prepared on 7 September 2022. It was last reviewed on 27 May 2024.</p>

<p>This website was last tested on 19 April 2023. The test was carried out by the Design Ops team in line with WCAG-EM, using:</p>
<p>This website was last tested on 19 May 2024. The test was carried out by the Design Ops team in line with WCAG-EM, using:</p>

<ul>
<li>Screen-reader software</li>
Expand Down
2 changes: 1 addition & 1 deletion app/views/feedback.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
{% set pageName = "Feedback" %}
{% set pageDescription = "Give us feedback on this service." %}
{% set selectedNav = "" %}
{% set lastUpdated = "April 2023 "%}
{% set lastUpdated = "May 2024 "%}

{% block beforeContent %}{% endblock %}

Expand Down
6 changes: 3 additions & 3 deletions app/views/service-standard/1-understand-user-needs.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

{% set pageName = "Understand users and their needs" %}
{% set pageDescription = "This guidance will help you apply point 1 of the Service Standard in the Department for Education" %}
{% set pageDescriptionPageOverride = "This guidance will help you apply <a href='https://www.gov.uk/service-manual/service-standard/point-1-understand-user-needs' class='govuk-link' target='_blank' rel='noopener noreferrer'>standard point 1 (opens in new tab)</a>." %}
{% set pageDescriptionPageOverride = "This guidance will help you apply <a href='https://www.gov.uk/service-manual/service-standard/point-1-understand-user-needs' class='govuk-link' rel='noopener noreferrer'>standard point 1</a>." %}
{% set selectedNav = "Service Standard" %}
{% set lastUpdated = "April 2023"%}
{% set lastUpdated = "May 2024"%}
{% set backlog_issue_id = "" %}
{% set point = "1" %}

Expand Down Expand Up @@ -36,7 +36,7 @@

## Why it's important

You need to <a href="https://www.gov.uk/service-manual/user-research/start-by-learning-user-needs#understanding-user-needs" target="_blank">understand your users and their needs (opens in new tab)</a> to build something that helps them. Otherwise you could build the wrong thing or make DfE services more difficult to use.
You need to <a href="https://www.gov.uk/service-manual/user-research/start-by-learning-user-needs#understanding-user-needs">understand your users and their needs</a> to build something that helps them. Otherwise you could build the wrong thing or make DfE services more difficult to use.

Understanding as much of the context of the user needs as possible will give you the best chance of meeting them in the most simple, cost effective way.

Expand Down
10 changes: 5 additions & 5 deletions app/views/service-standard/10-define-success-publish-performance-data.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

{% set pageName = "Define what success looks like and publish performance data" %}
{% set pageDescription = "This guidance will help you apply point 10 of the Service Standard in the Department for Education" %}
{% set pageDescriptionPageOverride = "This guidance will help you apply <a href='https://www.gov.uk/service-manual/service-standard/point-10-define-success-publish-performance-data' target='_blank' rel='noopener noreferrer'>standard point 10 (opens in new tab)</a>" %}
{% set pageDescriptionPageOverride = "This guidance will help you apply <a href='https://www.gov.uk/service-manual/service-standard/point-10-define-success-publish-performance-data' rel='noopener noreferrer'>standard point 10 </a>." %}
{% set selectedNav = "Service Standard" %}
{% set lastUpdated = "April 2023"%}
{% set lastUpdated = "May 2024"%}
{% set backlog_issue_id = "" %}
{% set point = "10" %}

Expand All @@ -31,7 +31,7 @@

## Summary

Service teams will need to work out <a href="https://www.gov.uk/service-manual/measuring-success" target="_blank">what success looks like (opens in new tab)</a> for their DfE service. Collect performance information across all online and offline channels so that you can measure and show that the service is effective and improving.
Service teams will need to work out <a href="https://www.gov.uk/service-manual/measuring-success">what success looks like</a> for their DfE service. Collect performance information across all online and offline channels so that you can measure and show that the service is effective and improving.

## Why it's important

Expand All @@ -49,7 +49,7 @@

- define what you want to measure and why and how these measurements will be obtained. Potential options for collecting this data could include:
- analytics which describe time spent on pages, heatmaps, if users start something but don't finish it
- <a href="https://www.gov.uk/service-manual/measuring-success/using-data-to-improve-your-service-an-introduction" target="_blank">performance data (opens in new tab)</a> and reporting, to capture baseline measurements on service efficiency, timescales, service level agreements (SLAs)
- <a href="https://www.gov.uk/service-manual/measuring-success/using-data-to-improve-your-service-an-introduction">performance data</a> and reporting, to capture baseline measurements on service efficiency, timescales, service level agreements (SLAs)
- qualitative data, which could include insights from users on the current as-is service captured via user research and feedback
- evidence of finding baseline data, or why this is not available, with a plan to show how you will measure future success
- evidence of how the team have iterated and improved metrics and data collection plans as you learn more about user needs
Expand Down Expand Up @@ -86,7 +86,7 @@ <h3 class="govuk-summary-card__title">Things to avoid in alpha</h3>
- evidence of performance data being used to make decisions about how to fix problems and improve the service
- engagement with business owners and stakeholders to help to make decisions using performance data
- ways to collect metrics and data are iterated and improved as the team learns more about user needs
- regularly <a href="https://www.gov.uk/service-manual/measuring-success/data-you-must-publish" target="_blank">publishing performance metrics (opens in new tab)</a>, these must include cost per transaction, user satisfaction, completion rate and digital take-up
- regularly <a href="https://www.gov.uk/service-manual/measuring-success/data-you-must-publish" >publishing performance metrics</a>, these must include cost per transaction, user satisfaction, completion rate and digital take-up
- when moving to live, learnings from metrics in beta are applied

## Profession specific guidance
Expand Down
22 changes: 11 additions & 11 deletions app/views/service-standard/11-choose-the-right-tools-and-technology.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

{% set pageName = "Choose the right tools and technology" %}
{% set pageDescription = "This guidance will help you apply point 11 of the Service Standard in the Department for Education" %}
{% set pageDescriptionPageOverride = "This guidance will help you apply <a href='https://www.gov.uk/service-manual/service-standard/point-11-choose-the-right-tools-and-technology' target='_blank' rel='noopener noreferrer'>standard point 11 (opens in new tab)</a>" %}
{% set pageDescriptionPageOverride = "This guidance will help you apply <a href='https://www.gov.uk/service-manual/service-standard/point-11-choose-the-right-tools-and-technology' rel='noopener noreferrer'>standard point 11 </a>." %}
{% set selectedNav = "Service Standard" %}
{% set lastUpdated = "April 2023"%}
{% set lastUpdated = "May 2024"%}
{% set backlog_issue_id = "" %}
{% set point = "11" %}

Expand Down Expand Up @@ -37,15 +37,15 @@

Build a sustainable service which allows you to change direction in future.

Detailed guidance of how to meet this standard can be found in <a href='https://dfe-digital.github.io/architecture/#dfe-architecture' target="_blank" rel="noopner noreferrer">DfE Architecture guidance (opens in new tab)</a> and <a href='https://technical-guidance.education.gov.uk/guides/default-technology-stack/' target="_blank" rel="noopner noreferrer">DfE Technical Guidance (opens in new tab)</a>.
Detailed guidance of how to meet this standard can be found in <a href='https://dfe-digital.github.io/architecture/#dfe-architecture' rel="noopner noreferrer">DfE Architecture guidance</a> and <a href='https://technical-guidance.education.gov.uk/guides/default-technology-stack/' rel="noopner noreferrer">DfE Technical Guidance</a>.

## Why it's important

When you make a decision about technology, you're making a significant investment. The choices you make will have a huge impact on your ability to create, iterate and operate the service in a flexible, sustainable way.

It's important to make sure you're not working on your own and use learnings from other teams or services where possible. Always try to align technology choices with other DfE teams. The more common components that are created and used the more efficient you can be in building a great service that meets the Service Standard.

When you make a decision about tools, look across DfE to see what's currently being used. <a href='https://www.gov.uk/guidance/share-and-reuse-technology' target="_blank" rel="noopner noreferrer">Align with tools (opens in new tab)</a> being used across other DDaT communities as much as possible.
When you make a decision about tools, look across DfE to see what's currently being used. <a href='https://www.gov.uk/guidance/share-and-reuse-technology' rel="noopner noreferrer">Align with tools</a> being used across other DDaT communities as much as possible.

## How to meet this standard in every phase

Expand All @@ -54,26 +54,26 @@
#### Things to consider:

- evidence that the team have considered different options to how the service will be delivered technically and the rationale for the chosen technical direction
- technology choices are technically feasible and <a href="https://educationgovuk.sharepoint.com/sites/security/SitePages/assurance.aspx" target="_blank">security assured (opens in new tab)</a>
- technology choices are technically feasible and <a href="https://educationgovuk.sharepoint.com/sites/security/SitePages/assurance.aspx" target="_blank">security assured (opens intranet page in new tab)</a>
- the tools the team will be using and why they are value for money
- how the tools and technology you choose meet <a href="https://design.education.gov.uk/accessibility/standards">accessibility standards </a> , including <a href='https://www.w3.org/TR/WCAG21/' target='_blank'>Web Content Accessibility Guidelines (WCAG) 2.1 (opens in new tab)</a>
- how the tools and technology you choose meet <a href="https://design.education.gov.uk/accessibility/standards">accessibility standards </a> , including <a href='https://www.w3.org/TR/WCAG21/'>Web Content Accessibility Guidelines (WCAG) 2.1</a>
- any constraints with legislation, contracts or technology that impact on the service
- align technology choices with the recommended <a href="https://technical-guidance.education.gov.uk/guides/default-technology-stack/" target="_blank" rel="noopner noreferrer">tech stack (opens in new tab)</a> used across DfE, where possible
- align technology choices with the recommended <a href="https://technical-guidance.education.gov.uk/guides/default-technology-stack/" rel="noopner noreferrer">tech stack</a> used across DfE, where possible
- a working prototype, technical spikes, or proof of concept - using the chosen tools and technology - has been built and tested to prove that the architecture is fit for purpose
- architectural artefacts, <a href="https://dfe-digital.github.io/architecture/standards/architecture-documentation/#architecture-documentation" target="_blank" rel="noopner noreferrer">decisions (opens in new tab)</a> and plans have been documented, shared across your community and reviewed and assured
- architectural artefacts, <a href="https://dfe-digital.github.io/architecture/standards/architecture-documentation/#architecture-documentation" rel="noopner noreferrer">decisions</a> and plans have been documented, shared across your community and reviewed and assured
- evidence that the team will continue to re-evaluate and challenge previous decisions as new requirements are discovered
- demonstration that <a href='https://www.gov.uk/guidance/make-your-technology-sustainable' target="_blank" rel="noopner noreferrer">technology choices are sustainable (opens in new tab)</a> longer term
- demonstration that <a href='https://www.gov.uk/guidance/make-your-technology-sustainable' rel="noopner noreferrer">technology choices are sustainable</a> longer term

## Profession specific guidance

Each DDaT profession in DfE has their own community and guidance.


<p class="govuk-body-l govuk-!-font-weight-bold">
<a class="govuk-link" href="https://dfe-digital.github.io/architecture/#dfe-architecture" target="_blank">Architecture</a>
<a class="govuk-link" href="https://dfe-digital.github.io/architecture/#dfe-architecture">Architecture</a>
</p>
<p class="govuk-body-l govuk-!-font-weight-bold">
<a class="govuk-link" href="https://technical-guidance.education.gov.uk/" target="_blank">Technical Guidance</a>
<a class="govuk-link" href="https://technical-guidance.education.gov.uk/">Technical Guidance</a>
</p>


Expand Down
22 changes: 11 additions & 11 deletions app/views/service-standard/12-make-new-source-code-open.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

{% set pageName = "Make new source code open" %}
{% set pageDescription = "This guidance will help you apply point 12 of the Service Standard in the Department for Education" %}
{% set pageDescriptionPageOverride = "This guidance will help you apply <a href='https://www.gov.uk/service-manual/service-standard/point-12-make-new-source-code-open' target='_blank' rel='noopener noreferrer'>standard point 12 (opens in new tab)</a>" %}
{% set pageDescriptionPageOverride = "This guidance will help you apply <a href='https://www.gov.uk/service-manual/service-standard/point-12-make-new-source-code-open' rel='noopener noreferrer'>standard point 12</a>." %}
{% set selectedNav = "Service Standard" %}
{% set lastUpdated = "April 2023"%}
{% set lastUpdated = "May 2024"%}
{% set backlog_issue_id = "" %}
{% set point = "12" %}

Expand All @@ -31,17 +31,17 @@

## Summary

Teams should aim to make all new source code open and reusable, and publish it under <a href='https://technical-guidance.education.gov.uk/standards/licencing-software-or-code/' target="_blank" rel="noopner noreferrer">appropriate licences (opens in new tab)</a>. DfE specific guidance of how to meet this standard can be found in <a href='https://technical-guidance.education.gov.uk/standards/storing-source-code/' target="_blank" rel="noopner noreferrer">DfE Technical Guidance (opens in new tab)</a>.
Teams should aim to make all new source code open and reusable, and publish it under <a href='https://technical-guidance.education.gov.uk/standards/licencing-software-or-code/' rel="noopner noreferrer">appropriate licences</a>. DfE specific guidance of how to meet this standard can be found in <a href='https://technical-guidance.education.gov.uk/standards/storing-source-code/' rel="noopner noreferrer">DfE Technical Guidance</a>.

## Why it's important

Public services are built with public money. Unless there's a good reason not to the code they're based on, should be made available for other people to reuse and build on.

Open source code can save teams duplicating effort and help them build better services faster. Publishing source code under an open licence means that you're less likely to get locked into working with a single supplier.

Coding in the open is a good way to encourage high quality and <a href="https://www.gov.uk/government/publications/open-source-guidance/security-considerations-when-coding-in-the-open" target="_blank" rel="noopner noreferrer">secure coding (opens in new tab)</a> in development teams.
Coding in the open is a good way to encourage high quality and <a href="https://www.gov.uk/government/publications/open-source-guidance/security-considerations-when-coding-in-the-open" rel="noopner noreferrer">secure coding</a> in development teams.

There may be times when code should not be published in the open. For example, secrets, keys or sensitive information should not be published to public repositories. DfE has guidance on <a href="https://technical-guidance.education.gov.uk/infrastructure/security/managing-secrets/#content" target="_blank" rel="noopner noreferrer" >managing secrets (opens in new tab)</a> and closed code.
There may be times when code should not be published in the open. For example, secrets, keys or sensitive information should not be published to public repositories. DfE has guidance on <a href="https://technical-guidance.education.gov.uk/infrastructure/security/managing-secrets/#content" rel="noopner noreferrer" >managing secrets</a> and closed code.


## How to meet this standard in every phase
Expand All @@ -50,28 +50,28 @@

#### Things to consider:

- Any code being produced should be <a href="https://technical-guidance.education.gov.uk/standards/storing-source-code/" target="_blank" rel="noopner noreferrer">open by default (opens in new tab)</a>. If at any point the code was not publicly available, the team will be asked why, and without good reason, could fail an assessment.
- Any code being produced should be <a href="https://technical-guidance.education.gov.uk/standards/storing-source-code/" rel="noopner noreferrer">open by default</a>. If at any point the code was not publicly available, the team will be asked why, and without good reason, could fail an assessment.

## How to meet this standard in a secure way
### Use GitHub

The recommended tooling for meeting this standard is GitHub, as repositories in GitHub are open by default. There is a DfE organisation set up at <a href="https://github.com/DFE-Digital" target="_blank">DfE-Digital (opens in new tab)</a> which is publicly available.
The recommended tooling for meeting this standard is GitHub, as repositories in GitHub are open by default. There is a DfE organisation set up at <a href="https://github.com/DFE-Digital">DfE-Digital</a> which is publicly available.

It is important not commit secrets to code. If you have some information that must be secret, for example, passwords, you can use <a href="https://technical-guidance.education.gov.uk/infrastructure/security/managing-secrets/#access-secrets-from-github-actions" target="_blank" rel="noopner noreferrer">github secrets (opens in new tab)</a>.
It is important not commit secrets to code. If you have some information that must be secret, for example, passwords, you can use <a href="https://technical-guidance.education.gov.uk/infrastructure/security/managing-secrets/#access-secrets-from-github-actions" rel="noopner noreferrer">github secrets</a>.

Join DfE-Digital to create a repository for a new service by contacting the DfE Slack channel <a href="https://ukgovernmentdfe.slack.com/archives/CMS9V0JQL" target="_blank">#digital-tools-support</a>.

<a href="https://github.com/DFE-Digital/find-a-tuition-partner" target="_blank" rel="noopner noreferrer">Find a Tuition Partner (opens in new tab)</a> is an example of a GitHub repo in DfE.
<a href="https://github.com/DFE-Digital/find-a-tuition-partner" rel="noopner noreferrer">Find a Tuition Partner</a> is an example of a GitHub repo in DfE.

## Profession specific guidance

Each DDaT profession in DfE has their own community and guidance.

<p class="govuk-body-l govuk-!-font-weight-bold">
<a class="govuk-link" href="https://dfe-digital.github.io/architecture/#dfe-architecture" target="_blank">Architecture</a>
<a class="govuk-link" href="https://dfe-digital.github.io/architecture/#dfe-architecture">Architecture</a>
</p>
<p class="govuk-body-l govuk-!-font-weight-bold">
<a class="govuk-link" href="https://technical-guidance.education.gov.uk/" target="_blank">Technical Guidance</a>
<a class="govuk-link" href="https://technical-guidance.education.gov.uk/">Technical Guidance</a>
</p>

{% endmarkdown %}
Expand Down
Loading

0 comments on commit 1350783

Please sign in to comment.