Technical Writing Blog

We all can agree that content should be the primary focus of a technical writer. But, we also can’t just leave out other aspects of creating technical documentation. This is why we would like to focus on styling and formatting of your users docs in our article. Color Scheme While printed technical docs tend to…

Hundreds of tips can be found on the Internet on creating appealing resumes. There are some general guidelines and standards to follow regardless of the profession of choice. But, if you want to really impress your interviewer, you might want to be more creative. We are trying to help those pursuing a career in technical…

Hi, I’m Kesi Parker, a technical writer. I like to chat with technical writers on Facebook to get acquainted with new people and get new experience. And know what? In some companies, technical writers use MS Word or Google Docs for writing documentation. That’s why I’ve decided to write a post on Google Docs tricks…

Migrating to a new tool is a pain for anyone. Even when a new messenger is implemented in your company, there’s still this transition period. Yes, with sending messages being the primary function of an app, you still need time to get accustomed to the new UI. When you are a technical writer with many…

Technical writing requires tools for measurement and analysis like any other work process. Although, it is quite difficult to decide what metrics to use considering specifics of this field. We began discussing this topic a while ago and figured out the main aims of using metrics – you can either measure a documentation team’s productivity…

Punctuation in English is considered by many somewhat optional. But quotation marks are an exception here – you can’t skip them in such cases like a direct quote, for example. Quotation marks usage is often found confusing as British English and American English have different approaches towards this question. In this article, we will try…

An API without a good user manual is next to useless. Developers would like a clear view of an API, code examples, detailed explanation of calls and parameters. And, they are not the only people visiting an API documentation portal. Many people with different roles are involved in API nowadays as this sphere has gained…

What is a perfect help topic? It is a topic that delivers a solution to its readers in the most efficient manner. Creating such topics means paying attention to their every element and analyzing them. Further, you will find practical advice on improving each help topic element to create great technical documentation. Title It all…

Creating user manuals is a difficult task on its own. Making them good is even more difficult. If while reading these first two sentences you thought to yourself, ‘Well, my technical documentation is quite good, actually’ – you might be missing an important point here: there is always room for improvement. Stagnation inevitably leads to…

User documentation is the face your company shows to the world. Having quality manuals is just as important as having a great support team. Remember, a lot of issues get deflected without actual involvement of support if documentation is okay. Plus, support teams work with users based on documentation for the most part anyway. It…