{"id":27390,"date":"2022-05-13T13:58:46","date_gmt":"2022-05-13T11:58:46","guid":{"rendered":"https:\/\/www.wbscodingschool.com\/?p=27390"},"modified":"2022-05-13T13:58:46","modified_gmt":"2022-05-13T11:58:46","slug":"closing-a-tech-blog-fundamental-practices","status":"publish","type":"post","link":"https:\/\/www.wbscodingschool.com\/blog\/closing-a-tech-blog-fundamental-practices\/","title":{"rendered":"Closing A Tech Blog: Fundamental Practices"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">This is the sixth and final part of our series on how to write a tech blog that reads well. If you wish to read the previous entries, here is a table of contents linking back to all the previous articles!<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Article #1 \u2013&nbsp;<\/em><a href=\"https:\/\/www.wbscodingschool.com\/blog\/how-to-write-a-tech-blog-that-reads-well-1\/\"><strong><em>Fundamentals &amp; Essential Practices<\/em><\/strong><\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Article #2 \u2013&nbsp;<\/em><a href=\"https:\/\/www.wbscodingschool.com\/blog\/how-to-write-a-tech-blog-that-reads-well-2\/\"><strong><em>Structuring Your Blog &amp; Presentation<\/em><\/strong><\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Article #3 \u2013&nbsp;<\/em><a href=\"https:\/\/www.wbscodingschool.com\/how-to-write-a-tech-blog-that-reads-well-3\/\"><strong><em>Style<\/em><\/strong><\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Article #4 \u2013&nbsp;<\/em><strong><a href=\"https:\/\/www.wbscodingschool.com\/blog\/how-to-write-a-tech-blog-that-reads-well-4\/\"><em>Common Pitfalls<\/em><\/a><\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Article #5 \u2013&nbsp;<\/em><strong><em><a href=\"https:\/\/www.wbscodingschool.com\/blog\/how-to-open-your-tech-blog-like-a-pro\/\"><strong>Opening Your Blog<\/strong><\/a><\/em><\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Article #6 \u2013&nbsp;<\/em><strong><em>Closing Your Blog<\/em><\/strong> <strong><em>And Explaining Difficult Concepts<\/em><\/strong><\/p>\n\n\n\n<h1 class=\"wp-block-heading\"><strong>Closing Your Blog<\/strong><\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">Like titling, this is another topic in which we have a discrepancy between a blog\u2019s style and its efficiency in terms of generating traffic. If you\u2019re trying to get clicks, then final paragraphs are very important, and I will once again link a <a href=\"https:\/\/yoast.com\/seo-friendly-conclusion\/\" target=\"_blank\" rel=\"noopener\">helpful guide on how to write an SEO-friendly conclusion<\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">In terms of just <em>good writing<\/em>, however, conclusions carry a lot less weight than openers. If a reader has stuck with you until the end, it\u2019s unlikely their reading experience will change much based on the final paragraph (unless you really write something beastly).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">How should a conclusion be written? There are two possible answers, which depend on the type of article you are writing.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For technical articles with <a href=\"https:\/\/www.wbscodingschool.com\/how-to-write-a-tech-blog-that-reads-well-3\/\">an objective register<\/a>, it\u2019s every bit as simple as writing the opening, and more or less the same logic applies. First, declare that the article has reached the end, then express your hopes or best wishes. For example:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>This concludes our overview of the best text editors on the market. We hope our article helped you make an informed decision. Remember that the editor has to fit your needs, not the other way around, and of course \u2013 happy coding!<\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">That\u2019s pretty much all you need. For more stylistically sophisticated articles, there are two things you want to have in your conclusion.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Firstly, <em>clarification of potentially contentious points<\/em>. If you wrote an article about why it\u2019s a good idea to be more assertive in the office, you don\u2019t want that to be interpreted as telling people that they have to be jerks to each other. That\u2019s something you (should have) already specified in the body of the article, naturally, but make sure your final paragraph includes a reminder in that sense. Just to be sure.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Secondly, and this is considerably more difficult to pull off, you want your article to finish with a little bit of a punch. This isn\u2019t something very easy to teach, because what you\u2019re looking for is a memorable phrase \u2013 and what that is depends heavily on what you wrote in the article, and how that final phrase reflects on that. A few things you can do in this sense include:<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Vivid imagery or metaphors<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img fetchpriority=\"high\" decoding=\"async\" width=\"1024\" height=\"614\" src=\"https:\/\/www.wbscodingschool.com\/files\/2.-AdobeStock-by-sutadimages_274095365-1024x614.jpeg\" alt=\"creativity imagination and dreams concept.\" class=\"wp-image-27382\"\/><figcaption class=\"wp-element-caption\">Adobe Stock \/ Sutadimages<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">These usually stand out in an article, although they take some creativity and inspiration. If you can find a metaphor, a simile, or an image that relates to the topic you have been discussing, use that to wrap up your argument. It will give your reader\u2019s mind something concrete to carry away from the article, and a powerful mnemonic object that lets them remember what you said. Here are <a href=\"https:\/\/prowritingaid.com\/Metaphors\" target=\"_blank\" rel=\"noopener\">a few quick pointers on writing metaphors<\/a>, and they mostly work for similes and imagery in general.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Statement of belief or emotion<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">You can make your final sentence resonate simply by turning it into a short statement about how you feel, ideally related to the general argument you have discussed in the blog. For example: \u2018<em>Anyone can and will find a job if they take the time to learn Python. I believe that.<\/em>\u2019 Or alternatively: \u2018<em>As I left my job with Apple, I told my friends that I would never return to backend development again. And I meant every last word.<\/em>\u2019 The trick here is to make sure that the final, short statement is definitive. You\u2019re not going to pack any punch by saying \u2018I\u2019m pretty sure I believe that\u2019 or \u2018I meant what I said, to an extent\u2019. It\u2019s the definitiveness of those sentences that, coupled with the relatable intimacy of a personal feeling, makes them memorable.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Active statement<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">A less personal variation of the above, this just means closing your article with a short sentence, ideally one that ends with a verb. For example, \u2018<em>Hundreds of developers turned to Laravel to profit from their skills with PHP. And they did.<\/em>\u2019 It\u2019s possible to play around with this, of course; the sentence doesn\u2019t necessarily have to end with a verb (\u2018<em>And they did just that<\/em>\u2019). But the principle is the same as the above, except this time you create rhetorical impact not by relating the reader to a personal emotion, but to some form of action in the real world.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Famous quote<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">If you\u2019re really struggling to find an apt conclusion for your blog, even with the above suggestions, then an easy way to close is to Google famous quotes based on key words that can be related to your article. If you wrote an article about job hunting, you can Google quotes on \u2018perseverance\u2019, and then end your article by saying \u2018<em>Remember, as the saying goes, it\u2019s often the last key in the bunch that opens the lock.<\/em>\u2019 This is a passable method, but it\u2019s also a bit of a cop-out, and you really don\u2019t want to abuse it. Readers will start noticing if you do this too often, and eventually it will just come across as lazy (because it is).<\/p>\n\n\n\n<h1 class=\"wp-block-heading\"><strong>EXPLAINING DIFFICULT CONCEPTS<\/strong><\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">Knowing how to explain concepts that are difficult to understand is mandatory if you write blogs in tech. Here are a few techniques that you will want to make use of.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\"><em>Use diagrams, charts and other pictures<\/em><\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"409\" src=\"https:\/\/www.wbscodingschool.com\/files\/4.-AdobeStock-by-Monster-Ztudio_421019853-1024x409.jpeg\" alt=\"Business process and workflow automation with flowchart. Hand holding wooden cube block arranging processing management on yellow background\" class=\"wp-image-27386\"\/><figcaption class=\"wp-element-caption\">Adobe Stock \/ Monster Ztudio<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">I cannot stress how important visual aids are when explaining abstract concepts. In most cases the mind can process an image much better than it can process words. So use diagrams, draw out concepts visually, and represent data as charts and graphs. Even if all you do is screen-grab a snippet of code from your console, do it. It helps.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Pictures aren\u2019t just useful in their own right, they also break up your text both visually and conceptually. Readers will associate pictures to concepts, and therefore \u2018map out\u2019 your article as they read it.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">How to <em>create<\/em> a good diagram is a question beyond the remit of this article (and frankly beyond the expertise of this writer). Ideally, you should be able to find ready-made pictures online to help you out. Otherwise, you should keep pictures you create relatively simple, with straight, geometric lines and patterns, and liberal use of primary colors. Consider drawing stick figures too, and don\u2019t worry about them looking rudimentary \u2013 they will add a human, relatable element to your image, which offsets any issue about how \u2018pretty\u2019 it is.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><em>Writing about difficult concepts<\/em><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Let\u2019s move on to the actual writing bit of explaining difficult concepts. Here are a few pointers that you should always keep in mind.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"738\" src=\"https:\/\/www.wbscodingschool.com\/files\/5.-AdobeStock-by-JackF_185060412-1024x738.jpeg\" alt=\"Man at desk at office makes important documents on notebook\" class=\"wp-image-27388\"\/><figcaption class=\"wp-element-caption\">Adobe Stock \/ JackF<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><em><strong>Language matters, tone doesn\u2019t<\/strong><\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Most blogs out there that cover how to explain difficult concepts suggest using simple language and short sentences, and writing in an informal, light tone. The former is essential \u2013 keep complicated vocabulary to a minimum, and avoid long sentences wherever possible, as they will make it even harder for your reader to focus.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The latter, on the other hand, is a myth \u2013 keeping your tone casual doesn\u2019t necessarily make your explanation(s) more accessible. You can use a dry and formal tone if you are more comfortable that way, and as long as you keep the language simple, it will be just as clear.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em><strong>The \u2018jargon horseshoe\u2019<\/strong><\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Jargon that is key to the topic you are talking about <strong>must be defined<\/strong>. If you are explaining what SQL is, you can\u2019t gloss over the fact that it stands for Structured Query Language. But how and where in your blog should you bring this up?<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The answer is: you should say it twice \u2013 once at the very beginning of your explanation, then one more time at the very end. The first time you mention it serves to give your reader an anchor. Here\u2019s what we are explaining, here\u2019s what we\u2019re talking about. No room for ambiguity.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The second time comes at the very end of the explanation, once the concept is (hopefully!) clear in the mind of the reader. Make sure that defining jargon is the <em>first<\/em> and the <em>last<\/em> thing that you do whenever you explain a difficult concept. (It goes without saying that all of this holds for <em>necessary<\/em> jargon; complicated terms that are only indirectly relevant to what you are talking about should simply <em>not be used<\/em>).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em><strong>Metaphor<\/strong><\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Now that we know how to start and end our explanation, what should be the meat of it? The answer is in two parts.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">First, <strong>employ a metaphor or a simile to describe the topic you are writing about<\/strong>. This can be challenging \u2013 it\u2019s like having to explain your topic by explaining something else instead. Make it as visual and as situational as possible, allowing the reader relate to something familiar.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For example: \u2018<em>If you want to understand what a PHP engineer does, imagine somebody who can play the violin. A professional violinist is an expert with a tool that is mostly associated to outdated music, but in reality is one of the best things that can be learned to find paid work, as it\u2019s extremely flexible and used in more or less every genre<\/em>.\u2019<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">See what I did there? Everybody knows what violins are and more or less understands what their role is in the world of music. (This is a metaphor I actually carried much further, by writing <a href=\"https:\/\/www.wbscodingschool.com\/blog\/learning-php-is-like-learning-violin\/\">an entire article based around it<\/a>).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Once you have used a metaphor to ground the reader in the concept you\u2019re discussing, <em>then<\/em> you can pass to a more technical, nitty-gritty explanation of your topic. Again, just keep the language simple and straightforward, and use diagrams alongside.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">One word of advice though \u2013 avoid mixed or extended metaphors. If you want to explain what frontend and backend are, you should devote two separate metaphors to each explanation, rather than try and think of a single idea that can accommodate both. It may be seductive to try the latter solution, and some very talented writers can pull it off wonderfully, but in practice you are playing with fire. The more elements you put into any metaphor, the more likely you are to complicate rather than to simplify things.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em><strong>Add links<\/strong><\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can expand on your explanation by linking out to other articles (yours or anyone else\u2019s) that explain the inessential parts of what you are talking about. If you are trying to convey a sense of what a Data Scientist does, and you touch on the topic of programming languages, you can link to somebody else\u2019s article comparing Python and R. That may not be the topic of your blog as such, but it\u2019s a useful expansion for anyone who wishes to delve deeper into the topic.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">***<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">In summary then: Use lots of pictures combined with simple language, then follow the structure of a.) definining jargon, b.) illustrating with a metaphor\/simile\/analogy, c.) going for the technical explanation, d.) once again going over jargon. All of this should be enough to give your readers a good understanding of what you are talking about.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"682\" src=\"https:\/\/www.wbscodingschool.com\/files\/3.-AdobeStock-by-Song_about_summer_164646587-1024x682.jpeg\" alt=\"complex difficult task or question un business, problem concept\" class=\"wp-image-27384\"\/><figcaption class=\"wp-element-caption\">Adobe Stock \/ Song_about_summer<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">This concludes our extensive series on how to write a better tech blog! The irony is not lost on me that I just explained how to close a blog, and now found myself in the position of having to close this blog. I have already revealed my cards!<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">No tricks or techniques then. I hope this series was useful to you, and I wish you all the best. And if you feel like seeing some of the principles I talked about in practice, check out <a href=\"https:\/\/www.wbscodingschool.com\/blog\/imogen-drews-learning-to-code\/\">one of my favorite blogs about our graduate student Imogen Drews<\/a>. Keep writing!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This is the sixth and final part of our series on how to write a tech blog that reads well. If you wish to read the previous entries, here is a table of contents linking back to all the previous articles! Article #1 \u2013&nbsp;Fundamentals &amp; Essential Practices Article #2 \u2013&nbsp;Structuring Your Blog &amp; Presentation Article [&hellip;]<\/p>\n","protected":false},"author":17,"featured_media":27380,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"content-type":"","footnotes":""},"categories":[42],"tags":[],"class_list":["post-27390","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\/27390","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=27390"}],"version-history":[{"count":1,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/posts\/27390\/revisions"}],"predecessor-version":[{"id":62568,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/posts\/27390\/revisions\/62568"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/media\/27380"}],"wp:attachment":[{"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/media?parent=27390"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/categories?post=27390"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/tags?post=27390"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}