Technical Writing Blog

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…

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 title to subtitle, or to text elements that stand out visually (bold or italic font),…

When people hear the phrase instruction manual, they think about different step-by-step explanations of how to control devices, assemble furniture, repair computer accessories, do routine maintenance of equipment, etc. Such manuals are one of the most common and important things in technical writing. Whenever you purchase anything from electronics or any other product, there is…

What Is Technical Communication and Who Is a Technical Communicator? The definition of technical communication is the following: it is a type of communication that is aimed at providing readers with clear and accurate information on how to use and maintain products, complete tasks, operate equipment, etc. It is a means of conveying technical information…

Software development is such a process that differs from other kinds of engineering procedures. It requires the attention of a mobile and flexible team that is willing to respond quickly to changes. This is when Agile methodology steps in. Agile methodology is a set of routines oriented toward the efficiency improvement of software development specialists….

What Is a Technical Report? The definition of a technical report is the following: a technical report is a document written by a researcher; it describes how the research was conveyed: its phases, steps, results, peculiarities, etc., and may include deeper details like experimental data and outcome. It is a document that literally guides readers…

Imagine that every day you see dozens of mismatched PDFs that are produced and uploaded to some documentation site that doesn’t have navigation. Fellow tech writers are wasting loads of valuable hours fixing one thing across masses of documents when they could be creating new content instead. Seems like it’s the place to implement structure….

A Software Design Document (SDD) is known by different names; it is often called a software design specification, a software requirement document, or technical specs. This is a detailed description of the overall architecture of a piece of software. Why create it? Just imagine: your team has spent several months building a software product, and…

Many working environments demand collaborative writing and editing of documents. Nowadays, such collaborations are simplified. The participants don’t need to be co-located and work from the same office; they are free to reside in different geographic locations. In addition, documents are quickly and efficiently distributed through emails, phones, and chat or conferencing tools that let…

When you write documentation every day, you can’t help noticing that this process has phases and cycles that, in the majority of cases, are the same. They are called Document Development Life Cycle (DDLC). Document Development Life Cycle (DDLC) is a systematic process of document creation that has a cyclic order. Technical writers and content…