Technical Writing Blog

Technical Description - Definition A technical description may be an individual document or a part of some other document. It can consist of only a couple of sentences or be several pages long. Technical description is a type of technical Continue reading »

To tell the truth, technical documentation is a boring thing to read. If it contains text only, it is even worse. Users hardly ever read docs from cover to cover. They scan them. It looks like that: they jump from Continue reading »

Autonumbering is quite a useful feature. Basically, it means that as long as you keep adding new elements, each new element is getting an ordered number. Right now, you are probably all like - 'Aye aye, Captain Obvious! This feature Continue reading »

This article continues our post series on creating responsive online documentation. In the previous parts of this series, we have learned about mobile emulators and typical issues related to screen sizes. Now, it is time for some practice. We suppose that you have already identified issues in your content and in this post we will focus on specific ways to solve them with CSS Continue reading »

This article continues our post series on creating responsive online documentation. The first part considered free screen and mobile emulation tools - a "must read" for technical writers who care about mobile look of their content. Then we talked about Continue reading »

Last time, we talked about screen emulation tools to help you test your web content on different devices. In this post, we will make the next step and take a look at the tools helping you detect any UI issues Continue reading »

Have you ever thought of what your online documentation looks like when viewed on a 1920x1080 monitor or opened from an iPhone? Well, today you definitely should. It is not a secret for anyone that mobile browsers usage grows rapidly Continue reading »

Many online documentation formats are related to HTML in one way or another. At that, many online documentation topics are using the same visual layout - a header container with information and quick links; and the topic body in a Continue reading »