Technical Writing Blog

Technical writing and communication involves communicating complex information to specific audiences with clarity and accuracy. The key word here is communication, which is a term for two-way interactions. But in case of technical writing, the addressee side is shrouded in mystery. Technical writers often have a very vague idea of the end-users, their level of…

Almost any product has some kind of documentation to go with it. It might be just a warning or brief usage instructions. And, still, even then, there’s supposed to be a person allocated to write these two lines, and, more importantly, to decide what’s even supposed to be written. For more complex products, however, there…

The times when technical writers were using Notepad or MS Word to create user manuals are over. Now, we have a big and dynamic market of technical writing tools. But, the more solutions emerge – the more difficult it is to find the one that suits best. Or, even to figure out the right parameters…

In this blog post, you will find a quick step-by-step introduction into creating user manuals. This article will be useful for technical writers who are at the beginning of their professional journey and for experienced specialists as we will touch upon a very important question – help authoring tools. Moving to a specialized tool is…

We are living in an age when communication relies heavily on visual content. Visual communication is all around us. In order to experience it, we don’t have to visit an art gallery or watch a movie – we just need to take a look around: signs, logos, leaflets, books, mobile phones, and advertisements – visual…

Technical writing or technical communication is about delivery of technical information to the general audience. Using plain language in technical documentation allows to make the writing clear, concise and helpful to readers. Plain language writing helps the target audience easily perceive information, avoid misunderstandings and save time, because it gets the job done the first…

To jargon, or not to jargon: that is the question. Although technical writing and the word ‘jargon’ appeared long before Shakespeare, this is not exactly the famous question posed by Hamlet. Today it is a tricky matter which occupies the minds of specialists in technical communication and all sorts of writing. But first of all…

Hyphenation is a linguistic phenomenon which is quite often left out of grammar books. Nevertheless, there are rules that one must follow to use hyphens right. Technical writers, for example, need to make their user documentation look professional. Otherwise, their readers might think that the company itself is untrustworthy. Let’s try to figure out how…

Your documentation team is one busy department. Useful documentation heavily relies on your team’s ability to keep the workflow moving, but in a business where things are notoriously fast-paced, that can be a difficult thing to achieve. With that said, you might find another article interesting, that is – Documentation Team: How to Delegate Tasks….

Technical documentation is not just any text. It is a whole new world with its rules and patterns to follow. This article will explain how technical writers can avoid the most common mistakes when writing a user manual. Abbreviations Abbreviations are great. They save us time and effort. We can transmit information faster using abbreviations,…