Jan 13Superstitions of a Technical Writer531Bradley NiceI need my aroma candles near my laptop to delve into the work atmosphere and be on fire (no pun…I need my aroma candles near my laptop to delve into the work atmosphere and be on fire (no pun intended).1 min read1 min readI need my aroma candles near my laptop to delve into the work atmosphere and be on fire (no pun intended).----
Nov 11, 2022How to Edit Your Own Technical TextsIt doesn’t matter what you write — posts for social networks, scientific papers, or a novel: thoughtful editing is key to any high — quality text. The ability to edit your text is just as important as the ability to write it. Write a Draft Even if you write well, the first version…Editing3 min readEditing3 min read
Oct 28, 2022What Is API Documentation and Why Is It ImportantNowadays, APIs are everywhere. You can notice this acronym in all areas that have something in common with, for example, mobile applications. Moreover, it concerns various software products — e.g., online shopping stores and payment service providers. If such products need API, then clear documentation is required. What Is API? Application Programming Interface…API2 min readAPI2 min read
Oct 7, 2022How to Write the Best Troubleshooting Guide EverThis blog will explain how to create a clear and useful troubleshooting guide that will help your users solve all problems easily. Define Users’ Problems You should know the details of the problem because it’s not enough to get vague descriptions from your users. Ask users to take screenshots or record screens when…Troubleshooting2 min readTroubleshooting2 min read
Aug 12, 2022Why Do We Procrastinate at WorkHow often do you procrastinate at work? If you do so frequently, maybe you should totally change your lifestyle. So, let’s discuss the main reasons we procrastinate. Unclear Tasks Sometimes, it’s hard to complete a task due to vague explanations. For example, I face this problem when a client doesn’t know what…Procrastination3 min readProcrastination3 min read
Aug 4, 20224 Ways to Be a Bad Technical WriterProfessionals always advise newbies on how to become great specialists. However, sometimes it’s better to highlight bad practices to help novice technical writers remember and avoid them. So, read the post to learn more about that. Forget About Your Target Audience You won’t succeed If you don’t define your audience. For example, your task is…Technical Writing3 min readTechnical Writing3 min read
Jul 22, 2022Storytelling and Technical DocumentsPeople usually think that reading technical documentation is a tedious process. As a rule, they are tired of wordy sentences, unclear terms, and dry facts. Readers need easy-to-remember texts that are clear after the first perusal. So, how to make user guides attractive and unforgettable? Just write a story. The…Storytelling2 min readStorytelling2 min read
Jul 7, 2022What Is RFP Documentation?The fact is that every company has limited resources. If an organization doesn’t cooperate with other enterprises or professionals, it will face productivity problems. Creating an RFP allows businesses to find new partners. RFP stands for a request for proposal. This document allows companies to find a vendor or partner…Rfp3 min readRfp3 min read
Jun 30, 2022Technical Documentation Software for EnterprisesAlmost every company creates a lot of technical documentation. If an organization uses out-of-date software, employee productivity may suffer. Let’s take four reasons for companies to use a help authoring tool. 1. It makes employee communication easier. When a company has a lot of employees, they have to communicate with…Enterprise3 min readEnterprise3 min read
Jun 23, 2022Benefits of Smart DocumentationImagine the following situation: you work with documents in Microsoft Word daily. On the one hand, this tool has the AutoCorrect feature that helps you avoid mistakes; it’s better than a notepad. On the other hand, using MS Word isn’t enough for managing docs; you can insert only text and…Technical Writing3 min readTechnical Writing3 min read