An eye for an eyepatch: pirate’s guide to content strategy

To all my underappreciated hard-working
InfoDevs in the world, I dedicate this
dead man’s chest of doc cases.
And a bottle of rum. Harr!

‘No one ever reads documentation, why bother with it?’

Favorite opening line of any techie, heard every time when I introduce myself as an Information Developer. I hope I don’t burn in hell when I say that more often than not, I as an Information Developer agree.

Continue reading

100 Things Information Developer Should Do in the Lifetime

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

Diagram Series: Decrypting SME’s Drawings

User documentation that includes different types of graphics is more effective and easier to perceive than monotonous text. A diagram is just one type of graphics that prevails mostly in technical documentation. When creating diagrams on a daily basis, you eventually learn to overcome such difficulties as: vague explanations, inaccurate SMEs’ drawings, abundance of details, or lack of information. As an Information Developer, you must know how to combine these diverse chunks to create consistent graphics in user documentation. In this article, I will discuss some tips on decrypting SME’s drawings to make the process of creating diagrams an interesting and creative experience.

Continue reading

Buzzfeed test: your ideal SME

In her recent post, Natalia Bortkevych very astutely described the typical cases of SME interviews gone wrong.

In truth, when the subject is confusing enough in itself, it helps little to have an SME who has aversion to human race or talks in the “codish” variety of English.

Still, even if your SME is able in every way – approachable, knowledgeable, adorable – it’s no guarantee they will be willing to grant you an interview or a review if they are busy, even if you sorely need it. On the other hand, if you are disposed pleasantly towards each other and get along well, they’re bound to be more cooperative.

And while there are many tips and techniques for building that connection with your SME, sometimes it just happens naturally. It’s much like falling in love – you just have to find the right person.

We have designed this test to help you find out what kind of SME is your natural match!

smetype

Imagination_books

Poetry and Prose of Information Developer’s Life

For me, to find a perfect profession has always seemed to be even more difficult than to choose a favorite book. Some jobs were like societies of free poets—creative, funny, extraordinary, but at the same time too crazy and unstable. Other professions that I’ve been choosing look as if they were created by Marcel Proust—before you become interested in it, you should read a thousand pages, and overcome a routine and a desire to fall asleep. So, I was wandering as a Rimbaud’s drunken boat “in search of lost time” (and a place, certainly!), until I’ve accidentally found a new book with a very intriguing and promising title—Information Development. I must confess that when I’ve started discovering this book, I didn’t know the plot, the theme, and the main characters of it. But now, I’ve already read some chapters, and I can honestly tell you that this is a unique profession where poetry and prose are harmonically connected creating a “golden mean”.

So, let’s follow the white rabbit and see what this book is about!

Continue reading