{"id":26447,"date":"2022-04-05T09:27:46","date_gmt":"2022-04-05T07:27:46","guid":{"rendered":"https:\/\/www.wbscodingschool.com\/?p=26447"},"modified":"2022-04-05T09:27:46","modified_gmt":"2022-04-05T07:27:46","slug":"how-to-write-a-tech-blog-that-reads-well-2","status":"publish","type":"post","link":"https:\/\/www.wbscodingschool.com\/blog\/how-to-write-a-tech-blog-that-reads-well-2\/","title":{"rendered":"How To Write A Tech Blog That Reads Well \u2013 #2. Structure &#038; Presentation"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">This is the second 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\"><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\"><em>Article #2 \u2013 <strong>Structuring Your Blog &amp; Presentation<\/strong><\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><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\"><em>Article #4 \u2013 <strong><a href=\"https:\/\/www.wbscodingschool.com\/blog\/how-to-write-a-tech-blog-that-reads-well-4\/\">Common Pitfalls<\/a><\/strong><\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><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\"><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<\/strong><\/em> <em><strong>Explaining Difficult Concepts<\/strong><\/em><\/a><\/p>\n\n\n\n<p class=\"has-text-align-center wp-block-paragraph\">***<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>STRUCTURE<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><em><strong>1. HOW LONG SHOULD MY BLOGS BE?<\/strong><\/em><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">For a well-written article, you should expect the attention of a reasonably interested reader to hold for about 700 words. Anything beyond that needs to justify the extra length with a solid reason \u2013 you <em>really<\/em> need to be conveying important information. Articles over 1000 words will have to be very strong and\/or highly topical for readers to actually stick with them.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Naturally, the majority of the readers who click on your article will just be browsing, and are likely to enter with the intention of skimming over the first few paragraphs alone and then leaving. These readers are irrelevant to the question of how long your article should be, as they are unlikely to read the whole thing anyway. We will discuss how to spark and grab the attention of inattentive readers later in this series, but for now let\u2019s gloss.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Blogs under 700 words will struggle to offer anything more than very basic information \u2013 but if you <em>can<\/em> provide value in such a short space, then by all means go for it, and don\u2019t extend your article any more than is strictly necessary. <strong>If the content stays solid, then the shorter the better.<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">While the ideal range for most articles will fall somewhere between 700 and 1000 words, there is an important exception, which I will refer to as <em>consultation articles<\/em>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A consultation article is one that is not meant to be read from start to finish, but only consulted for those specific parts that the reader is looking for. It stands to regular articles the way that a dictionary stands to a novel.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Consultation articles are also not meant to be read just once, but to be returned to and referred back to frequently (including by the author themselves). Typical examples of such blogs include guides and how-tos divided into several, discrete steps, or lists of various important objects, tools, or concepts.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Consultation articles can afford to be as long as they like, and in fact they will often benefit from being 2000+ words. The one thing you should remember is to include a clear table of contents (ideally hyperlinked) explaining where each part of the article can be found.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>2. <em>PLANNING<\/em><\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The structure of your blog will be decided in the planning phase. If you already have a crystal-clear idea of what you want to communicate and how, you can try sitting down and writing the blog without a plan. This does sometimes work out, especially if you feel very inspired.<\/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-deagreez_319397102-1024x682.jpeg\" alt=\"Profile side view portrait of her she nice attractive lovely cheerful curious, wavy-haired girl creating notes love story isolated on bight vivid shine vibrant green blue turquoise color background\" class=\"wp-image-26378\"\/><figcaption>Adobe Stock \/ deagreez<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">In the overwhelming majority of cases, however, you\u2019ll just find yourself running out of steam halfway through, and\/or turning your entire draft inside-out during the revision process.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">It is much more advisable, before diving into the writing process itself, to <em>make a plan<\/em>. To do that, follow these steps.<\/p>\n\n\n\n<ul class=\"wp-block-list\" type=\"a\"><li><em><strong>Identify Key Points<\/strong><\/em><\/li><\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">To start making a plan, begin by identifying the key points you want to discuss in your blog. You can do this either by <strong>going over your research and your notes and finding parts that stand out to you<\/strong>, or by asking yourself the question <strong>\u2018What\u2019s something that my blog can\u2019t afford to <em>not<\/em> say?\u2019<\/strong>, and answering that as many times as necessary until you can\u2019t come up with anything else.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Then, summarize each key point in a single sentence. This doesn\u2019t mean a single sentence has to <em>say <\/em>everything there is to be said about that point, only that it has to remind you <em>what<\/em> that point is and <em>how<\/em> you\u2019re going to develop it.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For example (and going a bit meta now!), in my plan for the article you are reading now, the sentence I wrote for this section reads like this:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Planning \u2013 find key points, organize, sections &amp; sub-sections<\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The sentence won\u2019t mean anything to a reader, but it gives me as a writer a.) the key point itself, i.e. \u2018Planning\u2019, b.) the elements by which to discuss that key point, and c.) the order in which they should be discussed. Based on that, I can then go ahead and write these more extensive paragraphs you are reading.<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li><em><strong>Organize &amp; Merge<\/strong><\/em><\/li><\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Once you have your key points, it\u2019s time to rearrange them into the order they\u2019ll be presented in. For the simpler articles, those organized as a list (eg. \u2018The Top 10 Text Editors On The Market Today\u2019), this can be extremely easy. I once wrote an article on <a href=\"https:\/\/www.wbscodingschool.com\/blog\/underrated-european-cities-for-tech-jobs\/\">the most underrated European cities for tech jobs<\/a>, and here the order in which I chose to discuss the cities was frankly almost irrelevant.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"682\" src=\"https:\/\/www.wbscodingschool.com\/files\/AdobeStock-by-smolaw11_166398902-1024x682.jpeg\" alt=\"Businessman searching data in Stack of papers files on work desk in office, business report paper or piles of unfinished documents achives with clips on offices desk, Business concept\" class=\"wp-image-26382\"\/><figcaption>Adobe Stock \/ smolaw11<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">In most cases, however, you want to <strong>organize your points according to a <em>narrative<\/em>, meaning that they must follow logically from each other and build on each other<\/strong>. If you\u2019re writing an article on how to find a job as UX\/UI designer, for example, clearly what you have to say about CVs should come before what you have to say about interviews.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Key points that are very closely related should either be merged or turned into sub-sections of each other \u2013 again, as this very article is doing right now by treating \u2018Organize\u2019 and \u2018Merge\u2019 as a single key point.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For an article of 700-1000 words, you are looking at about four to five key points that you will need to identify. If you have more than that, merge and reorganize into sub-sections until you\u2019ve reached that number, and excise anything inessential.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If you\u2019re unable to do that, consider splitting your blog into two separate articles, or even more \u2013 a series of short blogs is often preferable to a single mammoth blog (the exception to this is <em>consultation articles<\/em> as described above).<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li><em><strong>Append Research Material To Key Points (Optional)<\/strong><\/em><\/li><\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">When writing the first draft, you should always have your list of key points before you and clearly in order. Often, however, you\u2019ll also have a substantial amount of material to consult while writing the article; these are the fruits of your research, which are not as easily summarised.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">In that case, do this: copy and paste your list of key points further down in your existing document or in a new document altogether. Then, <strong>below every key point, copy and paste all parts of the research material that are relevant to it<\/strong>. This way, whichever key point you happen to be writing about, you can always immediately refer to the relevant material just beneath it.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This practice is optional as different people have different preferred ways of organizing and consulting their research. It\u2019s what I usually do, but if you have a better way, go for it!<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>PRESENTATION<\/strong><\/h2>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"682\" src=\"https:\/\/www.wbscodingschool.com\/files\/AdobeStock-by-ipuwadol_458430631-1024x682.jpeg\" alt=\"Electronic signature, document management, paperless office, signing business contract concept, E-signing\" class=\"wp-image-26380\"\/><figcaption>Adobe Stock \/ ipuwadol<\/figcaption><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>1.<\/strong><em><strong> Titles &amp; Subtitles<\/strong><\/em><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Nowadays, the title of an article on the internet has less to do with style than with its value as a tool to generate traffic. On that topic, I will once again link you to <a href=\"https:\/\/backlinko.com\/on-page-seo\" target=\"_blank\" rel=\"noopener\">Backlinko\u2019s SEO guide<\/a>, which includes a helpful section entirely about titles and descriptions.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Because putting style before optimisation in your blog titles is, alas, so counterproductive, I will not discuss this topic here. If you have reached the point where you can afford to disregard the traffic-generating value of titles and thumbnails in your online writing, then you are probably well past needing my advice on writing.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">I will, however, recommend one thing only \u2013 <strong>a little bit of subtlety<\/strong>. Writing titles that leave the reader hanging a little bit, or which don\u2019t tell the whole story, is fine. Clear clickbait like \u2018You won\u2019t believe what she said next!\u2019 or \u2018The fourth one on the list is priceless!\u2019 are simply annoying, and if you care at all about your blog\u2019s presentation you should avoid them like the plague<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>2. <em>Paragraph Breaks<\/em><\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Four lines per paragraph is usually optimal for most regular blog formats out there. Three, five and six lines are still acceptable. More or less than that is either too light or too heavy and you should merge or split up your writing.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Naturally, this does not include single-sentence paragraphs which are deliberately kept short for&nbsp; rhetorical purposes, eg. \u2018Let\u2019s get started!\u2019, \u2018Are you ready?\u2019 \u2018And that was when I finally understood\u2019, \u2018Oh how wrong I was\u2019, and others of this kind<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>3. <em>Pictures<\/em><\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The blog\u2019s thumbnail picture should be in high resolution and feature predominantly clear and bright colours, as these attract the eye. Within the article itself, you can be a bit more flexible and choose whatever pictures you like.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Assuming your paragraphs are four lines long, you should include approximately one picture every four paragraphs (adjust for passages with longer\/shorter paras).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Pictures give a break to both the eye and the mind of your reader, which is why you should avoid the infamous \u2018walls of text\u2019. Any time that a reader sees nothing in their frame other than text, they should find an image the moment they scroll down again.<\/p>\n\n\n\n<p class=\"has-text-align-center wp-block-paragraph\">***<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">And this ends today\u2019s article on structure and presentation. Join us next week for the longest article of the series as we dive into the question of <em><strong>style<\/strong><\/em>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The second article in our series on how to write better blog posts.<\/p>\n","protected":false},"author":17,"featured_media":26376,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"content-type":"","footnotes":""},"categories":[45,42],"tags":[],"class_list":["post-26447","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-careers","category-coding"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/posts\/26447","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=26447"}],"version-history":[{"count":1,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/posts\/26447\/revisions"}],"predecessor-version":[{"id":62575,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/posts\/26447\/revisions\/62575"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/media\/26376"}],"wp:attachment":[{"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/media?parent=26447"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/categories?post=26447"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/tags?post=26447"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}