Concise writing: Unlocking The Secrets Of Effective Documentation

Concise writing is the key to improving readability, writing effectively, and creating effective documentation. Learn concise writing with a simple exercise.

Spoilers: You will achieve a 50% reduction in word count!

What is concise writing?

Concise writing is the art of creating concise content in documentation. It is the ability to say more with less. The top three characteristics of concise content are:

• Not redundant. Content doesn’t have repeating information.
• Well-structured. Content structure isn’t overly complicated, even if some procedures are complex.
• Without extra fluff. Content is tight.

As a technical writer, you must be able to condense information into digestible chunks. Your objective is to inform the user, not bore them with too much content. Therefore, learn and practice concise writing to become a skilled technical writer.

Let’s look at how you can improve the conciseness of your content.

Concise writing lesson 1: Never be satisfied with your first draft

As a technical writer, when you are creating the initial draft of the content, there is always a chance that content, though comprehensive in its own right, isn’t exactly usable. Typos, unnecessary material, grammatical issues, and formatting issues usually find their way into it.

This is generally because the first draft is based on whatever information you gather from the initial round of SME interviews and your notes. Therefore, every first draft must be subjected to a thorough self-review.

Self-reviews help you catch typos, grammatical mishaps, and formatting issues. Assuming that the information is accurate, of course!

If you are creating the content using MS Word or Google Docs, you can use their inbuilt grammar and spell-checking features. I prefer having an additional layer of security with a third-party tool such as Grammarly.

Concise writing lesson 2: Don’t get complacent with the second draft

After eliminating the basic errors from the document, give it a second pass of self-review. In this pass, you (hopefully) catch redundant or repeated information.

In some cases, it might be argued that repeating information is good. For example, if you are publishing documents online, then repeating some information is better than referring the reader to the information on another page or article.

Even in such cases, ensure that the repeated information is not an exact copy but a diluted or summarized version. You can also add a cross-reference to the full or original content to enable readers to get the information in detail if they so wish.

Concise writing lesson 3: Three is the magic number

Now that you’ve sorted grammatical errors, typos, and redundant information, it’s time for the third and final pass of self-review.

This is the most critical bit as in this round of self-review you ensure that the content is audience-centric, modular, and concise.

In this pass you look at ways to reduce the content, make it tighter if you will, while retaining the context, and also ensuring that the content is still centered around the audience.

Shortening the content aside, you can also look for opportunities to subdivide the content into smaller chunks, either as a separate paragraph or as a sub-section.

Your job is done only after you are convinced that the content cannot be reduced or split any further without losing the context.

It may all seem like a daunting task, especially if you are pressed for time or are just starting as a technical writer. But eventually, you will not need as many passes of self-review as your mind will start creating concise content in the first or second pass itself.

All you need is a little practice. Here’s a little exercise for you to try. I have also included my versions of different self-review passes to demonstrate how the content becomes more and more effective with each pass.

Concise writing exercise to improve readability

Take a look at the following passage and edit it to make it concise:

WhatsApp is a mobile application software owned by Meta that can be used to send and receive messages, like Facebook Messenger or Google Hangout. However, unlike those applications, you do not need an email account or an account on Facebook to use WhatsApp. You can just create an account using your mobile phone number. You can contact your friends using their mobile phone numbers. WhatsApp allows you to share not just text messages, but also images, videos, documents, and contacts.

Word count: 80

Rewrite the above passage keeping the characteristics of concise content in mind. Do multiple passes of the content. When you are satisfied with your edited version, look at mine and see how you fare.

Concise Writer exercise, here’s my edited version

First pass

Meta’s WhatsApp is an instant messaging service that uses your mobile phone number to send and receive text messages, documents, contacts, and media content. You can seamlessly connect with friends just like in Facebook Messenger or Google Hangout, but without needing to register with your email or create a separate account.

Word count: 45

Second pass

Meta’s WhatsApp is a messaging service like Facebook Messenger and Google Hangout. However, unlike them, you do not need a separate account to use it, just use your phone number. Since you use your phone number, you can easily connect with friends using WhatsApp.

Word count: 44

Analysis

Putting the original content through just two passes, I reduced the word count from 85 to 44, which is a 52% (51.75%) reduction! I practically halved the content without compromising its essence.

Here’s how I did it:

• Rephrased Meta’s ownership of WhatsApp by using the phrase, “Meta’s WhatsApp…”.
• Eliminated the need to mention the app’s category, instant messaging service, by comparing it with Facebook Messenger and Google Hangout.
• Establishing a comparison also eliminated the need to describe what WhatsApp can be used for, i.e. sharing text messages, media content, etc. by mentioning that it was similar to Facebook Messenger and Google Hangout. So, a user familiar with those two applications can immediately make sense of WhatsApp’s core function.

Let’s look at each sentence in the final version to see how I managed to retain the passage’s essence:

• Meta’s WhatsApp is a messaging service like Facebook Messenger and Google Hangout.
  • Establishes who owns WhatsApp.
  • Establishes WhatsApp’s core function.
• However, unlike them, you do not need a separate account to use it, just use your phone number.
  • Highlights essential differences between WhatsApp and the aforementioned applications.
• Since you use your phone number, you can easily connect with friends using WhatsApp.
  • Establishes what makes it stand out.

What is the word count in your final version? Did you beat my word count? Bravo, if you did! I am sure that you can reduce the content even more after your final edit.

Conclusion

There are a couple of ways to ensure concise content:

1. Concise writing is the key to writing effectively as a technical writer.
2. Concise writing content characteristics: not redundant, well-structured, and tight.
3. Your first draft is never enough.
4. Self-review at least thrice to improve your content’s effectiveness.
5. Read through your first draft and cut out the typos, grammatical errors, and formatting issues.
   Unless the content is a one-liner, which is rarely the case, there is always a possibility to trim the content.
6. Read through the second draft to look for redundant information. The second draft must basically relay the same information the first draft did.
7. Look for possibilities to edit the second draft. Are there multiple sentences that could be merged into one? Are there synonyms you could use? For example, the phrase “very tired” is the same as “exhausted”. Find such possibilities and replace them.
8. Rinse and repeat till you are satisfied that the content cannot be trimmed any further without losing its essence.

Once you make a habit of it, the number of edit passes you make will reduce and you will eventually be able to make the content concise in the first draft itself.

Here’s an article about effective documentation that you can check out!

I hope you found this article helpful. If you didn’t, then I would love to hear from you what I can do to improve it. For more technical writing-related articles and resources, see the Technical Writing page. Also consider following my YouTube channel learntechnicalwriting, Reddit community r/learntechnicalwriting and Quora space Technical Writer | Technical Writing for more such content.