Technical Writing Blog

As your business grows, the knowledge base of your company expands, and your employees might need new tools to manage it. Technical documents stored on PCs often get lost, or people just forget to share them in the common folders accessible to most users. Such a situation is typical for companies whose information is stored…

It is a well-known fact that English is the dominant language on a stage of global e-commerce, but this is not the case when one size fits all. It can be challenging for a company to launch its product or service to an international market dominated by local competitors. So software localization can help to…

What Is DITA? DITA is short for The Darwin Information Typing Architecture. It comprises the principles of specialization and inheritance that are much like the Darwinian theory. “Information typing” means the classification of information into topics, not “typing” as in keyboarding 🙂 “Architecture” is a hierarchy of elements or adaptable set of structures. It provides…

An FAQ is a list of frequently asked questions about a product or a service. They can be found on websites, occupy special forum sections, or be part of an online documentation portal. Fun fact – an FAQ section doesn’t necessarily cover questions that are frequently asked. It can be just any descriptive or technical…

ClickHelp is a tool for technical writers that offers enormous possibilities. We would like for each user to be able to use our software to its full potential. To help with that, I’ve come up with a list of mistakes to avoid when using ClickHelp. This list is perfect for our new clients, but even…

Let’s talk about versioning user manuals today. This concept has far more use cases than one might think. We will name some of the most popular ones and talk about the means ClickHelp, a cloud solution for help writing, offers to solve this! ClickHelp is based around the idea of reusing content and creating multiple…

Remember when you had to actually install software on your PC to write technical documentation. That wasn’t entirely terrible, but if you think about it… you had to worry about so many unnecessary things like system requirements, enough free space, security, and many more. Working from home wasn’t such a big thing until recently, but…

You can create a truly awesome user manual. Hundreds of topics that describe every product feature thoroughly. Navigation elements that are conveniently located throughout the documentation. Your readability score is high. You’ve configured styles and scripts in your online documentation portal according to your needs. It’s been going great, except… How are you going to…

ClickHelp has grown a lot for the past few years in terms of clients and feature-wise. If you think about it, these two facts are connected. Listening to our clients and fine-tuning our development road map based on the feedback is how we prefer to move forward. Although ClickHelp is a pretty straightforward help authoring…

In this blog, we are mostly talking about classic user manuals and use those as a general example. Today we are going to look closer at two very popular use cases that are a bit different – FAQs and knowledge bases. Specifically, we will talk about how to make the most of them using ClickHelp….