There are a lot of Style Guides out there, but it doesn’t happen that often that you find yourself reading the whole guide from A to Z in one sitting. Without further ado, introducing voiceandtone.com – voice and tone guide for MailChimp.
One of the things you need to give a thought to when preparing the docs is the user data that will show up on your screenshots and in your examples.
A very straightforward and down-to-earth example – the sign-up functionality for a website. Let’s take a very common case like signing up for Twitter.
A picture is worth a thousand words. And while reading the actual book may be the ‘proper’ thing to do, you can always get away with visuals & short summaries just to get a quick and easy grasp of what the whole thing is about. With that in mind, I’d like to share some of the resources based on Made to Stick by Chip and Dan Heath that we reviewed in one of our previous posts.
… people don’t buy quarter-inch drill bits.
They buy quarter-inch holes
so they can hang their children’s pictures.
‘Made to Stick’ by Chip and Dan Heath
A young and passionate CEO carefully crafts new strategy that will revolutionize the company standing and even the industry itself, yet his brilliant idea falls on the deaf ears of the stakeholders.
A dedicated scientist discovers a dead-sure cure for an untreatable disease, yet the scientific community dismisses the idea and leaves thousands of ill people in the dark although their lives could so easily have changed for better.
The marketing department of a food chain finds a customer success story that will make into a beautiful campaign for the brand, yet the management shrugs off the idea 15 minutes into the presentation.
It doesn’t have to be all that tragic, and contrary to what is seems, the actual villain here is not at all the thick-skinned management.
As an Information Developer, your work usually starts with opening an authoring tool of choice, creating a template and styles, writing the content, and producing a piece of consistent writing.
Well, most of the time. This applies to some 80–90 % of your time when you’re not busy digging information and interviewing SMEs. One of the things that you might be requested to do in your spare 10 % of time is to proofread some internal company or project documents. Usually, the process of proofreading involves Word documents and dealing with the following aspects:
- Spelling and grammar errors
- Naming conventions
- Overall structure and the level of details
A good spellchecker will save you the trouble of having to fix absolutely all spelling and grammar errors. There’s no proper artificial intelligence out there yet, so no one can handle structure and the level of details for you. But what do you do with formatting and naming conventions?
You can make more friends in two months by becoming interested in other people than you can in two years by trying to get other people interested in you.
Remember the usual TechComm trouble? Getting other people to acknowledge your presence and importance as a team member? Turns out practically everything that needed to be said was actually said a century ago.