{"id":26877,"date":"2022-04-22T01:10:59","date_gmt":"2022-04-21T23:10:59","guid":{"rendered":"https:\/\/www.wbscodingschool.com\/?p=26877"},"modified":"2022-04-22T01:10:59","modified_gmt":"2022-04-21T23:10:59","slug":"how-to-write-a-tech-blog-that-reads-well-4","status":"publish","type":"post","link":"https:\/\/www.wbscodingschool.com\/blog\/how-to-write-a-tech-blog-that-reads-well-4\/","title":{"rendered":"How To Write A Tech Blog That Reads Well &#8211; #4. Common Pitfalls"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\" id=\"block-aaecfe0b-9124-4c68-9aa9-d1767536370f\">This is the fourth part of our series on how to write a tech blog that reads well. If you wish to read previous entries or find out what will come up next, this is a table of contents that will be updated with links as the series progresses.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\" id=\"block-eefa0a0a-1eb3-4f1c-be17-981837d74653\"><em>Article #1 \u2013 <strong><a href=\"https:\/\/www.wbscodingschool.com\/blog\/how-to-write-a-tech-blog-that-reads-well-1\/\">Fundamentals &amp; Essential Practices<\/a><\/strong><\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\" id=\"block-f9d20cf1-eafc-4299-8221-aadd79a3ab15\"><em>Article #2 \u2013 <strong><a href=\"https:\/\/www.wbscodingschool.com\/blog\/how-to-write-a-tech-blog-that-reads-well-2\/\">Structuring Your Blog &amp; Presentation<\/a><\/strong><\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\" id=\"block-f799fe1e-ace5-4276-a166-0b651e0021b3\"><em>Article #3 \u2013 <strong><a href=\"https:\/\/www.wbscodingschool.com\/how-to-write-a-tech-blog-that-reads-well-3\/\">Style<\/a><\/strong><\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\" id=\"block-3a6bcf44-64ec-4d6a-8158-9a6efb1e110d\"><em>Article #4 \u2013 <strong>Common Pitfalls<\/strong><\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\" id=\"block-66e0663d-e3ac-48e7-9444-936afa769784\"><em>Article #5 \u2013 <strong><a href=\"https:\/\/www.wbscodingschool.com\/blog\/how-to-open-your-tech-blog-like-a-pro\/\">Opening Your Blog<\/a><\/strong><\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\" id=\"block-8166c56d-8034-465b-84d4-77d1cd51304f\"><em>Article #6 \u2013 <\/em><a href=\"https:\/\/www.wbscodingschool.com\/blog\/closing-a-tech-blog\/\"><em><strong>Closing Your Blog<\/strong><\/em> <em><strong>And Explaining Difficult Concepts<\/strong><\/em><\/a><\/p>\n\n\n\n<h1 class=\"wp-block-heading\">COMMON PITFALLS<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">Leaving aside the fundamentals, which <a href=\"https:\/\/www.wbscodingschool.com\/blog\/how-to-write-a-tech-blog-that-reads-well-1\/\">I have already covered<\/a>, there are a number of common mistakes that are often made by writers even of a relatively high level. I have identified 3 of them, and they are recurring enough that they deserve their own article.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">1. Weasel Words<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Weasel words are those words which mean little or nothing, but which we employ because we feel they make a sentence easier or more natural to read. Words such as \u2018Just\u2019, \u2018Like\u2019, \u2018So\u2019, \u2018Now\u2019, \u2018Quite\u2019, \u2018Then\u2019.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Every writer has weasel words of their own, sometimes a lot more specific and atypical than those above. This is inevitable, because we inherit them from speech, where their purpose is to extend our sentences and give us more time to think. Unfortunately, they are utterly counterproductive in writing.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">There is no surefire method to counter weasel words except to be aware of their existence, keep an eye open, and get rid of them when they appear. The sentence \u2018Let\u2019s just sit down and think about it\u2019 can be simplified to \u2018Let\u2019s sit down and think about it\u2019 with no loss.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Granted, the sentence above also doesn\u2019t <em>gain<\/em> very much except a little brevity, but <strong>the overall benefit of removing weasel words is incremental<\/strong>. Readers are much better at noticing your writing quirks than you\u2019ll ever be, and if a certain unnecessary word appears 4 times in the same article, they will perceive it as a stylistic limit. The more weasel words you remove, the more you foreclose this perception.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">And if you think that you don\u2019t use any weasel words yourself \u2013 then get to work! That almost certainly means you do.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">2. Tangents<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Certain very talented writers can fill their articles with tangents and still make them compelling to read, but in the vast, <em>vast<\/em> majority of cases, <strong>stepping away from the central topic\/argument of the blog has the effect of instantly losing the reader\u2019s interest<\/strong>.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img fetchpriority=\"high\" decoding=\"async\" width=\"1024\" height=\"682\" src=\"https:\/\/www.wbscodingschool.com\/files\/AdobeStock-by-WoGi_96322178-1024x682.jpeg\" alt=\"\" class=\"wp-image-26881\"><figcaption>Adobe Stock \/ WoGi<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">I\u2019m not just talking about including personal anecdotes in a technical article. I mean <strong>literally any sentence that does not directly contribute to the central argument of the article<\/strong>, regardless of how appropriate it may be <a href=\"https:\/\/www.wbscodingschool.com\/how-to-write-a-tech-blog-that-reads-well-3\/\">in terms of register or tone<\/a>. If you come across such a sentence when redrafting your article, excise it mercilessly. If you find one and you\u2019re not sure if it is or isn\u2019t important, excise it too \u2013 if you\u2019re not sure, it almost certainly means it wasn\u2019t important.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The fact that you love this or that particular passage makes no difference \u2013 every writer falls in love with what they write, but the fact that you\u2019re particularly fond of a sentence doesn\u2019t mean that the sentence should be there, nor that it serves the article.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">How do you avoid tangents? The answer is simply to <a href=\"https:\/\/www.wbscodingschool.com\/blog\/how-to-write-a-tech-blog-that-reads-well-2\/\">do the planning phase properly<\/a>. As long as you\u2019ve thought out and organized the narrative of your article beforehand, and you just expand on your key points as you originally set them down, you\u2019ll find that your language will stay on point too.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">3. Meandering Sentences<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Among the most common writing mistakes, even among otherwise excellent writers, is that of overlong sentences. The best way to demonstrate what I mean is by example, so let\u2019s take a look at this passage:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Learning how to code is really not very different from learning how to play music, as both are creative disciplines which demand commitment and practice, and in both cases learners will be faced with an immensely vast field in which they\u2019ll have to choose a specific starting point, from picking an instrument, to a genre, to a community, in accordance with what they are trying to do and be.<\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">In terms of grammar, there\u2019s nothing wrong with this paragraph. But it\u2019s an eyesore for the simple reason that it\u2019s way too long. A period in a sentence allows a reader to absorb a concept or a statement before moving on to the next one, but when a sentence does not stop, the reader will try and \u2018hold\u2019 everything in mind until they reach the end. This \u2018holding\u2019 costs mental fatigue, and therefore reading pleasure.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Let\u2019s try breaking down the above sentence, using a variety of punctuation options:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Learning how to code is really not very different from learning how to play music. Both are creative disciplines which demand commitment and practice; in both cases, learners will be faced with an immensely vast field, and will have to choose a specific starting point within it \u2013 pick an instrument, pick a genre, pick a community, in accordance with what you are trying to do and be.<\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This is a lot easier on the reader, and we also see how periods, semicolons and dashes can all be used to break up the sentence to slightly different effects.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This is not an unbreakable rule, but you should generally keep most of your sentences at a length of about 1 to 2 lines on a standard Word document at font-size 12. That\u2019s about 15 to 35 words per sentence. Going below that is fine, naturally, but going above that threshhold means you should probably \u2013 not certainly, but probably \u2013 add a period somewhere and split the sentence.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Use commas any time that you have a short \u2018intro\u2019 for your sentence (\u2018Apparently,\u2026\u2019 \u2018Presently,\u2026\u2019 \u2018In truth,\u2026\u2019 \u2018To be honest,\u2026\u2019), and any time that you add a <a href=\"https:\/\/www.grammarly.com\/blog\/subordinate-clause\/\" target=\"_blank\" rel=\"noopener\">subordinate clause<\/a>. Avoid using the same conjunction (\u2018and\u2019, \u2018or\u2019) twice in a sentence \u2013 if you do that, split the sentence at one of the two conjunctions.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Finally, read your sentences out loud to yourself. If you have trouble reaching the end without catching your breath, it\u2019s almost certainly too long.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>And that\u2019s it for now! Join us next week to read up on how to open your blog.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>The fourth article in our series on how to write better blog posts.<\/p>\n","protected":false},"author":17,"featured_media":26879,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"content-type":"","footnotes":""},"categories":[42],"tags":[],"class_list":["post-26877","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-coding"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/posts\/26877","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/users\/17"}],"replies":[{"embeddable":true,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/comments?post=26877"}],"version-history":[{"count":1,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/posts\/26877\/revisions"}],"predecessor-version":[{"id":62571,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/posts\/26877\/revisions\/62571"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/media\/26879"}],"wp:attachment":[{"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/media?parent=26877"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/categories?post=26877"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/tags?post=26877"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}