Skip to main content Intelligence Community Design System ICDS Get started Accessibility Styles Components Patterns Community
Skip to page content Show navigation section

Voice and tone

Voice

Voice is like our personality. When we write, we want to appear that the 'user interface is talking to the user' and remember that everyone needs to understand what we're trying to say. Therefore our voice is personal, inclusive and plain-spoken.

We:

  • Address the user as 'you'.

  • Avoid using 'should' as it can sound patronising.

  • Use 'can' and 'may' appropriately – 'can' implies ability and 'may' implies permission and even uncertainty.

  • Use language that is open, inclusive to all and that our users want us to use.

Tone

Tone is like our mood. We adapt our tone depending on the context.

For example, we may use a direct, serious and reassuring tone when writing about a new government legislation or data handling policy.

Tips

Active not passive voice

Active voice is easier to read because it identifies the 'thing' that's doing the action.

Words like 'was' or 'by' may indicate that you're writing in a passive voice.

Like this... Not like this...
Matt checked out the 'Content Style' document. The 'Content Style' document was checked out by Matt.
The app encountered a problem. A problem was encountered by the app.

Be direct

Writing 'to the point' will help you write simple content.

The simple principle is about getting readers the information they want as quickly as possible.

Like this... Not like this...
Read the instructions that came with your laptop. Consult the guidance that came with your laptop for further instructions.

Swap formal words for normal ones

Use language you would use if you were talking with the person you’re writing to.

This... Instead of...
Person User
About Approximate
App Application
Ask Request
Buy Purchase
Cancel Discard, Abort
Complete Successful
Confirm Validate
Divide Allocate
Fix Resolve
Get Obtain
Give Provide
Go with Accompany
Help Assistance
Maintain Support, Keep
Make sure Ensure
More information More guidance
Never Not
Next Adjacent
Own Possess
Question Query
Remove Delete, Trash
Send Forward
Stay Remain
Stop Discontinue
Take part Participate
Tell Notify, Recommend
Try Attempt
Use Utilise
A or b or both A and/or b
For example e.g.

Last reviewed 19 April 2024 .
Navigated to Voice and tone - Intelligence Community Design System