The term boilerplate came from the 1800s when boilerplates were steel plates used in making boilers for ships. Steam boilers were built from weighty rigid steel sheets. The newspaper industry took on the term to describe “a unit of writing that can be used over and over without change.”

So nowadays, boilerplate text is any written text that you can reuse in new contexts or applications without significant changes to the original.
A boilerplate sums up the compelling story for a brand in a clear description that you can easily include in corporate communications. …


Technical writing is a kind of writing based on the simplification of complex technical concepts for end-users. A tech writer creates documentation about technical or specialized topics, such as computer applications, medical procedures, environmental regulations, etc. All such documents aim at informing, guiding, instructing, and commanding certain information so that a reader can understand and utilize the details.

Every writer should have an idea of who they’re writing for. Apply this information to write highly targeted materials. People who work on technical matters rarely put that much effort into defining their audience, yet it may be even more critical for…


Every writer strives to be a good writer. But what does it mean “good”? The notion is too vague and subjective. Better to aim at being an effective writer. Yep, that’s easier to evaluate because there are some aspects of effective writing. Such writing means understanding how to create a document to meet reader needs, is valuable, and helps readers timely access the information they need.

Must-Haves of Effective Writing

There are four techniques of effective writing:

  1. Be competent at your content. Everyone should believe you know what you’re writing. In addition to fact-based, reasonable explanations to convince readers, you should also make your…


Any employee is a tool that can achieve good results if used correctly, namely, to motivate, set tasks, and adequately manage their execution. From this point of view, technical writers are similar to a system administrator or a programmer. A technical writer, like a designer, needs to be integrated into the team to get the desired result. Moreover, it is necessary to “customize” the workflow or instead give him the essential tools.

Although there are few technical documentation development environments globally, many companies continue to insist on using what they think is a universal tool — MS Word. But for…


In traditional grammar, voice is the quality of a verb that indicates whether its subject acts (active voice) or is acted upon (passive voice). This element of writing style allows you to manage how your reader understands what you are saying. It is essential in technical writing. Depending on the communication situation and the document you make, you might want to create a sense of objectivity, authoritative distance, or make the information active and immediately accessible.

Similar to evaluating the appropriate level of technicality for your audience, considering how your word and grammar choices affect your reader will give you…


There may be periods in your technical writer’s work when you don’t have any projects due. The best use of your downtime is to apply it for learning more about your job. So in this article, I gathered some good books for people working in technical writing and wanting to learn more about it, and by improving your skills, you help the company and yourself — more knowledge/skills = higher pay and promotions, etc.

  1. The Insider’s Guide to Technical Writing, 2012, Krista Van Laan

Every complex product needs to be explained to its users, and technical writers are the ones…


Workplace miscommunication refers to misunderstandings that occur when team members don’t communicate effectively, and their audience doesn’t understand their intent or meaning. Such misconception can lead to dissatisfied employees, high turnover rates, and costly missed deadlines.

When I was at the beginning of my career in the tech writing field, I had a very strict supervisor. He was a great professional, and we still get together from time to time, but back then, he seemed so intimidating to me that I sometimes couldn’t find the courage to address him with some questions. …


I’m a professional tech writer for years now, and publishing new content still gives me shivers from time to time. It happens every time I press the “Publish” button. My thoughts go: Is my document correctly structured? Was I straightforward enough for people to understand my message? How about punctuation or grammar?

All writers (and tech writers are no exception) experience this feeling of anxiety when sharing or publishing their content widely. While the reasons why we experience this concern vary, the common thread among them is that we’re afraid because we care. We care enough to create something useful…


Everyone involved in technical communication knows that audience targeting is crucial for technical writing. That’s because it’s so important for the writer to have a clean image of the intended audience in mind — who they are, their background, their goals for reading, and so on. The most impactful writing associates itself with the reader. It uses their vocabulary and what they know about the subject matter while giving them what they want. Knowing your reader also enables the writer to use the right psychology-based tactics for engaging them.

But what about the behind-the-scenes processes that affect how readers absorb…


The central tenet of the slow philosophy is taking the time to do things properly, and thereby enjoy them more.” — Carl Honoré

Today my post is not about writing, or about something technical, it’s about life, slow life. The slow life is the cultivation of “slow-motion,” defined as movement or action at a relaxed or leisurely pace to improve the quality of life. It all started with “slow food” in Italy at the end of the 80s when the citizens of Rome protested against the construction of Macdonalds and fast-food in general on the piazza. These people managed to…

Amrit Singh

Passionate technical writer

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store