Technical Writing Blog

Our previous post was addressed to problems with technical documentation. So, we set up a poll on our Telegram Channel. According to it, technical writers’ biggest concern is that people don’t read documentation. Imagine how frustrating this is – all the work you put in just to learn it was pointless. This sounds demotivating. Let’s…

There are certain issues that are very common for technical documentation teams all over the world. We will not only name them in this blog post but will also provide comprehensive solutions. Let’s begin. You Don’t Have a User Manual Or, rather, you wouldn’t call what you have a user manual. This is easily the…

Technical documentation is very complicated as it is. Don’t let your readers get lost in it! Give them a helping hand – navigation. Ideally, readers don’t need to be conscious of navigation elements they use. Moving between help topics should feel intuitive and seamless. This can be achieved if you have the right toolset at…

Why do we recommend using visual elements in technical documentation? Well, the answer is simple – the human brain is very good at distinguishing colors and understanding patterns. So, when you add maps, graphs, charts, infographics, dashboards, etc. to text, you are doing a big favor to readers and yourself. Using visualization techniques as a…

Sometimes, we get so used to looking at things from a certain perspective that it is getting increasingly harder to see how it may look for others. For instance, no matter how important it is for technical writers to think like readers to deliver better user manuals, it can be a tough call. Let’s shift…

Marketing is viewed as a separate field in business. Marketing teams are responsible for attracting potential clients and taking action to persuade them that the product holds the solution they were looking for. However, a lot of factors influence this process, and often they are out of the marketing team’s scope. Let’s take a technical…

Being replaced by a machine is a common fear several generations share. Technical writers included. And, it feels like now is the perfect time to re-evaluate the chances. Especially, since we seem kind of close to a real breakthrough with AI. However, this is not a brand new feeling. Will AI Conquer Planet Earth? The…

How can you tell a professional tech writer from a newbie? It is always easier to figure out what the pros should do than actually go into what they never do. This article will give you the right idea of a true techcomm pro. Use this guide to your benefit and get one step closer…

Today we will look at a question that seems to be bothering techcomm newcomers and not only them: how do I discipline myself? Especially when the backlog keeps growing, I have to be chasing fickle deadlines constantly and procrastination is calling me. Zen Out! Technical writing is tough. Tasks come in waves and it can…

Aviation is a rapidly developing high-tech field. Technologies used in modern aviation are mind-blowing. And, they require technical documents. To be more precise – every little detail requires a document when it comes to planes and other aircraft. Let’s take a look at what it means to be a technical writer in aviation. Specifics of…