Technical Communicators (aka Instruction Whisperers) are haunted by a great deal of creepy/funny stories. Let us share some ghostly nightmares of our own.
Be our guest and treat yourself to:
By Orysia Gaba
Jeez, what keeps you awake at night?
When writing documentation, target audience is one of the first things on mind of an information developer. Audience determines what deliverable to choose, as well as what style and tone to apply to it. Wrong idea of the target audience’s needs may result in total failure of documentation. Therefore, a good information developer should be aware of every possible target user. Having deep knowledge of the product, understanding the aim of the documentation and the audience – their needs, possibilities, desires, and preferences, results in a masterpiece documentation.
So, how do we know what our target user wants? The answer is research! And I did a little research of my own on one of the most fast-growing generations in history. Millennials. So, let’s have a closer look at them and try to do our best to meet their expectations.
Do you spot flaws or imperfections others do not see? Do you place high demands on yourself and people around you? Do you set extremely high standards? In other words, are you constantly striving for perfection?
If your answer is YES!, then welcome to the club of perfectionists.
A long time ago in a galaxy far, far away…
…a small group of information developers decided to create a repository of their knowledge and experience, the temple of the interesting facts gathered from the corners of the technical communication world, the maze that should lead others to the informational enlightenment – the Informaze blog. They planted a tiny seed and now they can witness their blog growing high and fast like a huge beautiful tree. Each blogpost on Informaze is carefully and tenderly grown by the information developers like an apple by the gardeners. Today we have 100 fruits on the tree of knowledge – 100 articles on Informaze!
In the 100th article, I’ve decided to accumulate the most essential elements of the “true information developer”, and find out what we should do in the lifetime to have an honor of calling ourselves “masters of information”.
Are you ready to remind yourself what a long, exiting, and breathtaking maze you go through every day? Continue reading
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.
0. Ghost-Tip. Never waste your time for introduction.
1. Be general. Don’t go into details, you don’t need to provide actual information. Write “The software is useful.” Enlisting the spheres of application is for dummies. Your readers are the best. They are working as prophets and reading your mind in their free time. Why spell it out for them?
Other questions you definitely don’t need answering: