{"id":290,"date":"2020-01-20T02:13:00","date_gmt":"2020-01-20T02:13:00","guid":{"rendered":"https:\/\/ctoinsight.com\/?p=290"},"modified":"2020-01-20T02:13:02","modified_gmt":"2020-01-20T02:13:02","slug":"effective-technical-writing","status":"publish","type":"post","link":"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/","title":{"rendered":"Technical Writing &#8211; Clarity, Brevity, and Conciseness"},"content":{"rendered":"\n<p>Three things to strive for in technical writing are clarity, brevity, and conciseness.  Whether it&#8217;s an email, a blog post, or message, keeping these three qualities in mind can help ensure effective communication with the audience.  The idiom &#8220;<a href=\"https:\/\/idioms.thefreedictionary.com\/short+and+sweet\">Keep it short and sweet<\/a>&#8221; is a helpful reminder and a good start but what is meant by &#8220;sweet&#8221; in this context?<\/p>\n\n\n\n<p>Technical writing is different from other forms of writing in that its purpose is to convey technical information, often from an expert author to an audience with lesser expertise.  Its purpose may also be communicating ideas to a group of technical peers.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Clarity<\/h2>\n\n\n\n<p>Writing must be easy to understand or it won&#8217;t achieve its purpose.  One thing that can lead to misunderstanding is ambiguity.  Take for example, the following sentence:<\/p>\n\n\n\n<p class=\"has-text-align-center\"><em>I saw a man on a hill with a telescope.<\/em><\/p>\n\n\n\n<p>Who had the telescope?  Me, the man, or the hill? Who was on the hill?  Me or the man?  One technique I use is to read my writings from the perspective of a novice.  Pick someone you know who doesn&#8217;t have have much knowledge in the area and re-read your piece from their perspective.  Where will they be confused?  Where can you add clarity?<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Brevity<\/h2>\n\n\n\n<p>How much of a time commitment are you asking the reader to make?  Does your article really need to be that long?  How many topics are you covering?  Are you going off on tangents?  Are you providing unnecessary detail?<\/p>\n\n\n\n<p>Some topics do require more length than others and there is no hard guideline for how long the writing should be.  But always keep length in mind and be respectful of the reader.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Conciseness<\/h2>\n\n\n\n<p>Conciseness is a measure of the efficiency of your writing &#8211; your ability to convey information in as few words as possible.  My approach is to not worry about conciseness in my first draft but focus on this during revisions.  Often I can cut a significant amount of fat from the piece without losing any valuable content.  Be sure you don&#8217;t ramble on, go off on unnecessary tangents, or get too wordy.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Keep it Short and Sweet<\/h2>\n\n\n\n<p>So what does &#8220;sweet&#8221; mean in this context?  Sweetness in technical writing is a combination of clarity and conciseness.  Keeping your technical writing short (brief) and sweet (clear and concise) will help make your readers happy and keep them coming back for more.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Three things to strive for in technical writing are clarity, brevity, and conciseness.  These qualities can help ensure effective communication with the audience.<\/p>\n","protected":false},"author":1,"featured_media":344,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[23],"tags":[],"class_list":["post-290","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-technical-writing"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.5 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Technical Writing - Clarity, Brevity, and Conciseness - CTO Insights<\/title>\n<meta name=\"description\" content=\"Three things to strive for in technical writing are clarity, brevity, and conciseness. These qualities can help ensure effective communication with the audience.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Technical Writing - Clarity, Brevity, and Conciseness - CTO Insights\" \/>\n<meta property=\"og:description\" content=\"Three things to strive for in technical writing are clarity, brevity, and conciseness. These qualities can help ensure effective communication with the audience.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/\" \/>\n<meta property=\"og:site_name\" content=\"CTO Insights\" \/>\n<meta property=\"article:published_time\" content=\"2020-01-20T02:13:00+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2020-01-20T02:13:02+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ctoinsight.com\/wp-content\/uploads\/2020\/01\/IMG_2945-rotated.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1512\" \/>\n\t<meta property=\"og:image:height\" content=\"2016\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Steve Kowalski\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Steve Kowalski\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/index.php\\\/2020\\\/01\\\/20\\\/effective-technical-writing\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/index.php\\\/2020\\\/01\\\/20\\\/effective-technical-writing\\\/\"},\"author\":{\"name\":\"Steve Kowalski\",\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/#\\\/schema\\\/person\\\/ae035f84ffb32d94aa6f4aa9b3780df0\"},\"headline\":\"Technical Writing &#8211; Clarity, Brevity, and Conciseness\",\"datePublished\":\"2020-01-20T02:13:00+00:00\",\"dateModified\":\"2020-01-20T02:13:02+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/index.php\\\/2020\\\/01\\\/20\\\/effective-technical-writing\\\/\"},\"wordCount\":409,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/#\\\/schema\\\/person\\\/ae035f84ffb32d94aa6f4aa9b3780df0\"},\"image\":{\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/index.php\\\/2020\\\/01\\\/20\\\/effective-technical-writing\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/ctoinsight.com\\\/wp-content\\\/uploads\\\/2020\\\/01\\\/IMG_2945-rotated.jpg\",\"articleSection\":[\"Technical Writing\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/ctoinsight.com\\\/index.php\\\/2020\\\/01\\\/20\\\/effective-technical-writing\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/index.php\\\/2020\\\/01\\\/20\\\/effective-technical-writing\\\/\",\"url\":\"https:\\\/\\\/ctoinsight.com\\\/index.php\\\/2020\\\/01\\\/20\\\/effective-technical-writing\\\/\",\"name\":\"Technical Writing - Clarity, Brevity, and Conciseness - CTO Insights\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/index.php\\\/2020\\\/01\\\/20\\\/effective-technical-writing\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/index.php\\\/2020\\\/01\\\/20\\\/effective-technical-writing\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/ctoinsight.com\\\/wp-content\\\/uploads\\\/2020\\\/01\\\/IMG_2945-rotated.jpg\",\"datePublished\":\"2020-01-20T02:13:00+00:00\",\"dateModified\":\"2020-01-20T02:13:02+00:00\",\"description\":\"Three things to strive for in technical writing are clarity, brevity, and conciseness. These qualities can help ensure effective communication with the audience.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/index.php\\\/2020\\\/01\\\/20\\\/effective-technical-writing\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/ctoinsight.com\\\/index.php\\\/2020\\\/01\\\/20\\\/effective-technical-writing\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/index.php\\\/2020\\\/01\\\/20\\\/effective-technical-writing\\\/#primaryimage\",\"url\":\"https:\\\/\\\/ctoinsight.com\\\/wp-content\\\/uploads\\\/2020\\\/01\\\/IMG_2945-rotated.jpg\",\"contentUrl\":\"https:\\\/\\\/ctoinsight.com\\\/wp-content\\\/uploads\\\/2020\\\/01\\\/IMG_2945-rotated.jpg\",\"width\":1512,\"height\":2016,\"caption\":\"Chinese bone script\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/index.php\\\/2020\\\/01\\\/20\\\/effective-technical-writing\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/ctoinsight.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Technical Writing &#8211; Clarity, Brevity, and Conciseness\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/#website\",\"url\":\"https:\\\/\\\/ctoinsight.com\\\/\",\"name\":\"CTO Insights\",\"description\":\"Thoughts on software and technology leadership\",\"publisher\":{\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/#\\\/schema\\\/person\\\/ae035f84ffb32d94aa6f4aa9b3780df0\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/ctoinsight.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"https:\\\/\\\/ctoinsight.com\\\/#\\\/schema\\\/person\\\/ae035f84ffb32d94aa6f4aa9b3780df0\",\"name\":\"Steve Kowalski\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/558ae6d325255bc5d2dd8dbf91724b3d5df6dbbd5c48e45bf8981de2b32907bb?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/558ae6d325255bc5d2dd8dbf91724b3d5df6dbbd5c48e45bf8981de2b32907bb?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/558ae6d325255bc5d2dd8dbf91724b3d5df6dbbd5c48e45bf8981de2b32907bb?s=96&d=mm&r=g\",\"caption\":\"Steve Kowalski\"},\"logo\":{\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/558ae6d325255bc5d2dd8dbf91724b3d5df6dbbd5c48e45bf8981de2b32907bb?s=96&d=mm&r=g\"},\"description\":\"Chief Technology Officer (CTO) - SaaS, Cloud, Agile\",\"sameAs\":[\"https:\\\/\\\/www.linkedin.com\\\/in\\\/drstevekowalski\\\/\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Technical Writing - Clarity, Brevity, and Conciseness - CTO Insights","description":"Three things to strive for in technical writing are clarity, brevity, and conciseness. These qualities can help ensure effective communication with the audience.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/","og_locale":"en_US","og_type":"article","og_title":"Technical Writing - Clarity, Brevity, and Conciseness - CTO Insights","og_description":"Three things to strive for in technical writing are clarity, brevity, and conciseness. These qualities can help ensure effective communication with the audience.","og_url":"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/","og_site_name":"CTO Insights","article_published_time":"2020-01-20T02:13:00+00:00","article_modified_time":"2020-01-20T02:13:02+00:00","og_image":[{"width":1512,"height":2016,"url":"https:\/\/ctoinsight.com\/wp-content\/uploads\/2020\/01\/IMG_2945-rotated.jpg","type":"image\/jpeg"}],"author":"Steve Kowalski","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Steve Kowalski","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/#article","isPartOf":{"@id":"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/"},"author":{"name":"Steve Kowalski","@id":"https:\/\/ctoinsight.com\/#\/schema\/person\/ae035f84ffb32d94aa6f4aa9b3780df0"},"headline":"Technical Writing &#8211; Clarity, Brevity, and Conciseness","datePublished":"2020-01-20T02:13:00+00:00","dateModified":"2020-01-20T02:13:02+00:00","mainEntityOfPage":{"@id":"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/"},"wordCount":409,"commentCount":0,"publisher":{"@id":"https:\/\/ctoinsight.com\/#\/schema\/person\/ae035f84ffb32d94aa6f4aa9b3780df0"},"image":{"@id":"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/#primaryimage"},"thumbnailUrl":"https:\/\/ctoinsight.com\/wp-content\/uploads\/2020\/01\/IMG_2945-rotated.jpg","articleSection":["Technical Writing"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/","url":"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/","name":"Technical Writing - Clarity, Brevity, and Conciseness - CTO Insights","isPartOf":{"@id":"https:\/\/ctoinsight.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/#primaryimage"},"image":{"@id":"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/#primaryimage"},"thumbnailUrl":"https:\/\/ctoinsight.com\/wp-content\/uploads\/2020\/01\/IMG_2945-rotated.jpg","datePublished":"2020-01-20T02:13:00+00:00","dateModified":"2020-01-20T02:13:02+00:00","description":"Three things to strive for in technical writing are clarity, brevity, and conciseness. These qualities can help ensure effective communication with the audience.","breadcrumb":{"@id":"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/#primaryimage","url":"https:\/\/ctoinsight.com\/wp-content\/uploads\/2020\/01\/IMG_2945-rotated.jpg","contentUrl":"https:\/\/ctoinsight.com\/wp-content\/uploads\/2020\/01\/IMG_2945-rotated.jpg","width":1512,"height":2016,"caption":"Chinese bone script"},{"@type":"BreadcrumbList","@id":"https:\/\/ctoinsight.com\/index.php\/2020\/01\/20\/effective-technical-writing\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/ctoinsight.com\/"},{"@type":"ListItem","position":2,"name":"Technical Writing &#8211; Clarity, Brevity, and Conciseness"}]},{"@type":"WebSite","@id":"https:\/\/ctoinsight.com\/#website","url":"https:\/\/ctoinsight.com\/","name":"CTO Insights","description":"Thoughts on software and technology leadership","publisher":{"@id":"https:\/\/ctoinsight.com\/#\/schema\/person\/ae035f84ffb32d94aa6f4aa9b3780df0"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/ctoinsight.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":["Person","Organization"],"@id":"https:\/\/ctoinsight.com\/#\/schema\/person\/ae035f84ffb32d94aa6f4aa9b3780df0","name":"Steve Kowalski","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/558ae6d325255bc5d2dd8dbf91724b3d5df6dbbd5c48e45bf8981de2b32907bb?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/558ae6d325255bc5d2dd8dbf91724b3d5df6dbbd5c48e45bf8981de2b32907bb?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/558ae6d325255bc5d2dd8dbf91724b3d5df6dbbd5c48e45bf8981de2b32907bb?s=96&d=mm&r=g","caption":"Steve Kowalski"},"logo":{"@id":"https:\/\/secure.gravatar.com\/avatar\/558ae6d325255bc5d2dd8dbf91724b3d5df6dbbd5c48e45bf8981de2b32907bb?s=96&d=mm&r=g"},"description":"Chief Technology Officer (CTO) - SaaS, Cloud, Agile","sameAs":["https:\/\/www.linkedin.com\/in\/drstevekowalski\/"]}]}},"_links":{"self":[{"href":"https:\/\/ctoinsight.com\/index.php\/wp-json\/wp\/v2\/posts\/290","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ctoinsight.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ctoinsight.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ctoinsight.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ctoinsight.com\/index.php\/wp-json\/wp\/v2\/comments?post=290"}],"version-history":[{"count":31,"href":"https:\/\/ctoinsight.com\/index.php\/wp-json\/wp\/v2\/posts\/290\/revisions"}],"predecessor-version":[{"id":387,"href":"https:\/\/ctoinsight.com\/index.php\/wp-json\/wp\/v2\/posts\/290\/revisions\/387"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ctoinsight.com\/index.php\/wp-json\/wp\/v2\/media\/344"}],"wp:attachment":[{"href":"https:\/\/ctoinsight.com\/index.php\/wp-json\/wp\/v2\/media?parent=290"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ctoinsight.com\/index.php\/wp-json\/wp\/v2\/categories?post=290"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ctoinsight.com\/index.php\/wp-json\/wp\/v2\/tags?post=290"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}