Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Sarah lombardi patch 1 #597

Closed
Changes from all commits
Commits
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
31 changes: 31 additions & 0 deletions apps/docs/src/common/pages/content-style-guide/voice-and-tone.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
<h1><span class="caption">Content style guide</span>Voice and tone</h1>
<h2>Home Office voice</h2>
<p class=”govuk-body”>Our voice should be consistent across all our products and services. It is who we are and how we want to be seen by others.</p>

<p class=”govuk-body”>Our voice is rooted in our core Home Office values: compassionate, courageous, respectful and collaborative.</p>

<p class=”govuk-body”>For our content, this means we want to speak to people in a way that is:</p>
<ul class=”govuk-list govuk-list--bullet">
<li>Human</li>
<li>Empowering</li>
<li>Respectful</li>
<li>Clear</li>
</ul>

<p class=”govuk-body”>What this means:</p>
<ul class=”govuk-list govuk-list--bullet">
<li>Being <strong>human</strong> means using the words our readers understand, being empathetic, and not being monotonous or formulaic. It is varied in structure. It is not matey or over familiar.</li>
<li><strong>Empowering</strong> language focuses on what you can do instead of what you cannot do, or what will be done to you. Speak to the reader. Write in the active voice and use ‘you’ where you can. Provide next steps.</li>
<li>A <strong>respectful</strong> voice is inclusive, considerate, sensitive, and neutral. It fosters an environment where all perspectives are valued and treated with dignity. It is not accusing or demanding.</li>
<li><strong>Clear</strong> language is unambiguous, precise, active, and decisive. It is transparent, honest about what we are doing and why, and clarifies and explains. It does not hide meaning behind legal or government jargon. A clear voice presents us as confident, trustworthy and organised.</li>
</ul>

<h2>Tone</h2>
<p class=”govuk-body”>The tone of our content will vary depending on user need and channel. Like in conversation, this is about us being responsive to the person and their context.</p>

<p class=”govuk-body”>Here are some examples:</p>
<ul class=”govuk-list govuk-list--bullet">
<li>The tone of our ‘Ask Metis’ HR virtual assistant is ‘conversational, informal, varied’</li>
<li>The desired tone for our case management system is direct, clear and active as staff use it do tasks, not ask for advice. It should avoid informal and colloquial language given the sensitivity of the information it holds.</li>
</ul>

Loading