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

Finding Inspiration at ETC 2016

It doesn’t come often that one beautiful summer morning you find yourself in a professional environment among quite a number of accomplished specialists of your bread-and-butter sphere. That you have a chance to acquire invaluable knowledge shared by true masters of their craft. That you build a strong network with your international colleagues for the sake of further cooperation, communication, self-development, and career opportunities.

This June, I jumped on a chance to pay a visit to the Evolution of Technical Communication event (ETC 2016) in Sofia, Bulgaria. So little it would be, if I said that speakers were just great delivering their hot-button topics. Diversity of approaches to speech delivering, quite a range of topics to think over, useful workshops, and marvelous networking organizational skills are to pinpoint when giving a feedback about the conference in Sofia.

My special attention though was heavily attracted by the approaches and techniques applied when producing technical developers’ documentation in the microservices environment. The topic was engagingly presented by Lukasz Gornicki, a technical writer in the past and currently a product owner in SAP Hybris, Poland. Lukasz also conducted a very vivid workshop on the REST API documentation the following day.


Related posts

https://informaze.wordpress.com/2016/06/09/conference-soap-etc-2016/


Continue reading

Usability In Technical Documentation

Information developers are professional users of all sorts of technical documentation, and our experiences inevitably range from genuine pleasure to absolute disappointment.

Our trained eye immediately picks out the obvious typos or inconsistencies. But how come that some texts, though technically and grammatically correct, just do not work the way they are intended to? With all the rules and guidelines, we often forget about the most important focus of technical documentation – the user. So, what is this usability factor that makes a document easy to understand and work with?

Continue reading