User adoption, or how to make users fall in love with your product

So, you say you have developed a new cutting-edge app, and now you want it to rock the tech world? Don’t want to dash your hopes, but it takes more than that to succeed. Let’s take a closer look at one of the TechCom trends–user adoption. Once you finish this article, you will understand what user adoption is, why it is so important, and how it can boost your production.

Continue reading

Handing a documentation project to another Technical Communicator: tips & tricks

The phases of project initiation and project closure are substantially covered in blog posts, talks, and other resources across the TechComm society. Today, I would like to address a less frequently discussed phase – replacing a technical communicator in a project team.

Continue reading

Documentation as a prerequisite for successful CSIS

Complex System of Information Security (CSIS) comprises a set of organizational and technical measures aimed to ensure the protection of information circulating in the system from disclosure, leakage, and unauthorized access (c).

If your company is implementing the CSIS, it’s in for reinforced credibility and boosted sales. And you as a Technical Communicator are in for a bumpy ride. 😊

Let’s take a look at a grueling journey of meticulously described processes, roadmaps, and guidelines that need to accompany every stage of the System development.

Continue reading

Myths about information development: Busted

People tend to create stereotypes about things they don’t have much insight into. I broke into information development from a different industry, and I’d like to share my own experience of mythbusting. 

Before starting my career as an Information Developer, I was a translator and had little awareness of the role and its responsibilities. As a philosopher once said, “Theory without practice is empty”, and I’m glad I got a chance to fill the void and break my stereotypes during the first month of practical experience. Let me share some of them with you. Continue reading

Microsoft Writing Style Guide 2018: Procedures and formatting highlights

In 2018, we devoted several  posts to the latest writing style guide from Microsoft:

Yet, Microsoft guidelines is the topic one can talk about endlesly, isn’t it? 🙂 This time, I decided to focus on a few aspects of procedure writing and formatting that grabbed my attention most.

Grab your favorite drink, turn up the sound, and don’t miss the quiz at the end of the video!

blog post cover

Here’s a sneak peek at the video highlights:

  • Use device-neutral verbs.

Users may interact with your product using various devices and input methods.

  • Minimize UI terminology (menu, tab, box, and similar.).

Fewer words make actions more clear. Compare these: “From the File menu, select the New option” and “Go to File > New”.

  • Mind the look and feel of your text.

Proper combination of font size, line spacing, and capitalization makes your text more scannable and easy to follow. Microsoft provides specific formatting advice to get you started.

Do you use these guidelines in your docs and did they make a difference for you? Let us know in the comments!

TechComm and Artificial Intelligence (overview of a podcast by Seth Earley)

Nowadays, artificial intelligence is a central subject in the constantly evolving world of technologies. It is believed that in the long run, it will define the next generation of software solutions. Simultaneously, there is a lot of anxiety that Artificial Intelligence (AI) is going to lead to significant labor displacement.

So, in the context of Technical Communication, does the advance of AI mean that our trade is doomed to extinction as well?

Continue reading

UX copywriting series. Dropbox feature descriptions

No matter what you’re writing—whether it’s a small tooltip or a long web article—you need to thoroughly check your writing before you publish it.

Good writing is not just about spelling, punctuation, and capitalization, though we definitely need to keep them in mind at all times, among like… a million other things.

During UI text review, InfoDevs point out things that non-professional writers would never think to think about. Today, I’d like to talk about the most typical things that we stumble upon during the UI text review.

2018-12-18_15-29-19

Brace yourselves – it’s going to be a long article but a 100% practical one and so worth a read! We’re going to discuss 6 reasons why Dropbox feature descriptions did not pass our UI text review.
2018-12-18_15-42-59
Continue reading