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.

Sign up for GitHub

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

Update voice-and-tone.tsx #608

Merged
merged 1 commit into from
Oct 2, 2024
Merged

Update voice-and-tone.tsx #608

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
8 changes: 4 additions & 4 deletions apps/docs/src/common/pages/content-style-guide/voice-and-tone.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ const Page: FC<PageProps> = ({ location }) => (
<p>It should be consistent across all our products and services. It is who we are and how we demonstrate our values of courage, compassion, respect and collaboration.</p>
<p>Here are some examples showing what we mean.</p>
<h3 id="human">Human</h3>
<p>A 'human' voice is empathetic, personal, and natural. It use words that the audience understands. Varying your sentence length and structure will help to make your content seem less rigid and monotonous. If you reuse templated text, make sure all the content is relevant to the user.</p>
<p>A 'human' voice is empathetic, personal, and natural. It uses words that the audience understands. Varying your sentence length and structure will help to make your content seem less rigid and monotonous. If you reuse templated text, make sure all the content is relevant to the user.</p>
<p>For example: 'You can work and study, and come and go as many times as you want before the permit expires.' rather than 'It allows employment, education and unlimited entry/exit.'</p>
<h3 id="empowering">Empowering</h3>
<p>Using an 'empowering' voice means focussing on what someone can do, rather than what they cannot do or what will be done to them. It provides options, next steps and support. Speak to the reader, use ‘you’ as much as you can, and write in the active voice.</p>
Expand All @@ -46,10 +46,10 @@ const Page: FC<PageProps> = ({ location }) => (
<h2 id="tone">Tone</h2>
<p>Tone can change depending on the audience or channel. Like in conversation, this is about being responsive to the person and the context.</p>
<p>Whatever tone we take, it should reflect our voice and values.</p>
<p>Here are some examples:</p>
<p>For example:</p>
<ul>
<li>Our HR virtual assistant is more chatty, informal and varied in tone than our static HR guidance and policies.</li>
<li>Our case management systems are direct, clear, professional and active in tone as staff need instructional and straightforward language that reflects their work processes and helps them to quickly and accurately complete tasks.</li>
<li>our HR virtual assistant is more chatty, informal and varied in tone than our static HR guidance and policies</li>
<li>our case management systems are direct, clear, professional and active in tone as staff need instructional and straightforward language that reflects their work processes and helps them to complete tasks quickly and accurately</li>
</ul>

<h2>Help improve this guidance</h2>
Expand Down
Loading