Content journey: from technical to marketing and social media

Most technical communicators I know can be divided into 2 types.

There are the ones who love creating general About/Welcome sections in their docs and get off on illustrating workflows, business value, etc.

And then, the ones who need a whole cake and then some to coax themselves into writing overviews and designing diagrams. It’s much easier for this type to write instructions about tangible, down-to-earth, even techy stuff.

My friend Viktoria Bezsmolna is the definitive type 1. Still, this free-spirited girl landed in our InfoDev department. But soon enough, she eloped to marketing. And then to PR. Now, she is a freelance writer and has her own blog – yay!

I finally decided to get to the bottom of how this journey worked out for her.

Our 1,5-hour interview was very thought-provoking, and here’s how it all summed up in my head.

Continue reading

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

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

hogwarts houses

User behavior types vs. Hogwarts houses

Earlier this year, I wrote several articles on how to document user personas, Hogwarts style.

Like, there are Gryffindorian how-to steps 1-2-3 good to go pal whoo-hoo you’re done! Or, you can have this very thorough, do-it-at-your-own-pace Hufflepuff tutorials with follow-up tasks that guarantee to put you on your feet. For our Slythery audience, we offer several quick&dirty pro tips, no bull. And yeah, Ravenclaw guys, those appendixes with super-tricky scenarios are for you.

…what a mess of styles, huh? 🙂 Anyhow, choose your house, and I’ll tell you more about what docs you’d enjoy!

https://informaze.wordpress.com/2016/03/02/user-behavior-types-vs-hogwarts-houses-part-1/ https://informaze.wordpress.com/2016/03/16/user-behavior-types-vs-hogwarts-houses-part-2/ https://informaze.wordpress.com/?p=1178&preview=true https://informaze.wordpress.com/2016/04/06/user-behavior-types-vs-hogwarts-houses-ravenclaw/

On the hush-hush side, I would love to write in an individual fun way for each of those houses. But since my invitation to Hogwarts has not arrived (yet!), for now, I am a Technical Communicator for enterprise software.

So, welcome to my world of neutral writing where jokes are not allowed.

Continue reading

https://www.flickr.com/photos/writethedocs/29807686535/in/album-72157674031974295/

Write The Docs Europe 2016. Takeaways

Ayeeeee @writethedocs again in beautiful Prague!

Thanks to the awesome organizers, speakers, and everyone with whom we talked the days away or even simply clinked glasses – this was a conference to remember!

And just what I remember most, it’s right here in this post.

Continue reading

User Assistance Inspector: 5-star hotel in Amman

Business trips take you places. And when your technical communicator mode is on (is it ever off?), beware, translators of restaurant menus and shop signs.

But what about the high-class institutions? Where’s the luxury, there’s usually a good service in good English. So let’s bury the linguistic hatchet and take this evaluation to the next level.

Today, I want to evaluate just how good the user assistance is in a 5-star hotel in Amman, Jordan.

And that would be Bristol Amman Hotel.

Continue reading

User behavior types vs. Hogwarts houses (Ravenclaw)

In documentation for software that covers a wide market, we – Technical Communicators – often make it our point to target an ‘average user’. You know, the one who is neither too sloth nor too attentive, interested in both the big picture and a specific check box, and honestly, this list is endless.

But the majority of users does tend to lean one way or the other and follow a different ‘content beacon’.

Being a Potterhead, I could not help associating different user behavior types with Hogwarts houses.
And guess what – they match like the Weasley twins.

Sort your users and learn how to create documentation that ticks for them!


Related articles

https://informaze.wordpress.com/2016/03/02/user-behavior-types-vs-hogwarts-houses-part-1/

https://informaze.wordpress.com/2016/03/16/user-behavior-types-vs-hogwarts-houses-part-2/

https://informaze.wordpress.com/?p=1178&preview=true

 

 

 


Continue reading