{"id":26680,"date":"2022-04-12T09:55:15","date_gmt":"2022-04-12T07:55:15","guid":{"rendered":"https:\/\/www.wbscodingschool.com\/?p=26680"},"modified":"2025-05-12T15:33:55","modified_gmt":"2025-05-12T15:33:55","slug":"how-to-write-a-tech-blog-that-reads-well-3","status":"publish","type":"post","link":"https:\/\/www.wbscodingschool.com\/blog\/how-to-write-a-tech-blog-that-reads-well-3\/","title":{"rendered":"How To Write A Tech Blog That Reads Well \u2013 #3. Style"},"content":{"rendered":"\n

This is the third 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

Article #1 \u2013 Fundamentals & Essential Practices<\/a><\/strong><\/em><\/p>\n\n\n\n

Article #2 \u2013 Structuring Your Blog & Presentation<\/a><\/strong><\/em><\/p>\n\n\n\n

Article #3 \u2013 Style<\/strong><\/em><\/p>\n\n\n\n

Article #4 \u2013 Common Pitfalls<\/a><\/strong><\/em><\/p>\n\n\n\n

Article #5 \u2013 Opening Your Blog<\/a><\/strong><\/em><\/p>\n\n\n\n

Article #6 \u2013 <\/em>Closing Your Blog<\/strong><\/em> And<\/strong><\/em> Explaining Difficult Concepts<\/strong><\/em><\/a><\/p>\n\n\n\n

STYLE<\/strong><\/h2>\n\n\n\n

1. <\/em><\/strong>Register \u2013 What Is It?<\/strong><\/em><\/h3>\n\n\n\n

Tech articles will be either subjective or objective in their register. This is not a dichotomy, it is a spectrum<\/em>, and articles may fall on a point close(r) to the center or to the extremes.<\/strong><\/p>\n\n\n\n

A subjective register implies writing in the first person, using colloquialisms and a casual tone, foregrounding how one feels about something, and often using humor. It is especially suited for blogs about, for example, someone\u2019s personal experience when learning to code, or when discussing one\u2019s career. It is the preferable register for narrative<\/em> articles, i.e. those which are intended to be read from start to finish.<\/p>\n\n\n\n

An objective register uses the second or third person but generally avoids the use of pronouns where possible (\u2018I think that<\/em>\u2026\u2019 gets dropped in favor of \u2018It could be argued that<\/em>\u2026\u2019). The tone is academic, and the language technical. The author will usually not mention themselves in the text unless a disclaimer of some kind is necessary. This register is best suited for guides, how-tos, and walk-throughs of all nature. It\u2019s the one you should adopt for consultation articles<\/a><\/em>, which are intended to be selectively searched and repeatedly referred to.<\/p>\n\n\n\n

Let us look at two short paragraphs both about the same topic \u2013 writing your CV \u2013 written in a highly subjective and then in a highly objective register.<\/p>\n\n\n\n

Subjective register<\/strong>: The first time I tried stuffing everything I could do into my CV, I ended up writing an extra volume of<\/em> The Lord of the Rings. I needed to chop the damn thing down to essentials, but how does one even do that for a role in Software Architecture? And then something clicked \u2013 I had to spread the information out differently.<\/em><\/p>\n\n\n\n

Objective register<\/strong>: Clarity and brevity are key to writing a successful CV. One may object that roles of a more technical nature are difficult to write of concisely, but bear in mind that any skills developed in such roles can be highlighted in other sections of the CV as well.<\/em><\/p>\n\n\n\n

It\u2019s a good idea to put some conscious thought into what sort of blogs you want to write and for what readership, and then purposefully choose a register that matches that.<\/p>\n\n\n\n

2.<\/em> Register \u2013 How To Do It Right<\/em><\/strong><\/h3>\n\n\n\n

The key when it comes to register is consistency<\/strong>. You don\u2019t want to use different registers within the same article, and ideally you shouldn\u2019t be doing it across different articles either (assuming they are all part of the same blog).<\/p>\n\n\n\n

There is a crucial distinction to be made here: mixing<\/em> is bad, compromise<\/em> is good.<\/strong><\/p>\n\n\n\n

\"Top
Adobe Stock \/ deagreez<\/figcaption><\/figure>\n\n\n\n

What this means is that it\u2019s perfectly possible to find a register that falls somewhere between the two examples I provided above, one which is neither too casual nor too formal. The result may look something like this:<\/p>\n\n\n\n

A successful CV, at least in my experience, is one that is above all else clear and concise. You may feel that the more technical roles you worked in are difficult to summarize, and you\u2019d certainly have a point. But there are other ways of conveying that information within the same document.<\/em><\/p>\n\n\n\n

This is a compromise<\/em>, and it works perfectly well \u2013 recall that register is not a dichotomy but a spectrum.<\/p>\n\n\n\n

What you absolutely want to avoid is a paragraph with mixed<\/em> registers, which may look like this:<\/p>\n\n\n\n

When I first started writing my CV, I felt like a lost seal puppy in an icy wasteland. To spare you the same feels, the object of this article will be an enumeration of the writing avenues conducive to an optimal CV.<\/em><\/p>\n\n\n\n

You can choose any register you like for your articles \u2013 but once you\u2019ve got it, you have to stick<\/em> with it<\/strong>. If you notice yourself deviating from your register, amend that during the revision process.<\/p>\n\n\n\n

3. Finding Your Voice<\/em><\/strong><\/h3>\n\n\n\n

Finding your voice may sound like a concern for poets and novelists. In reality, it is at the heart of all good writing, and if you want your blog to read well, this is definitely something you should work on.<\/p>\n\n\n\n

To write \u2018in your voice\u2019 means to write in a way that feels spontaneous, natural, and to the extent that this is at all possible for writing, effortless. It is very much like talking. A conversation with a close friend doesn\u2019t feel burdensome, because you are speaking in your voice. A significant part of being a good writer is the ability to slip into this voice when putting pen to paper \/ fingers to keyboard.<\/p>\n\n\n\n

\"Wide
Adobe Stock \/ antianti<\/figcaption><\/figure>\n\n\n\n

Ironically, the best way to find your voice is to stop trying to write a good blog<\/em>. Assuming you have set down the key points of your article during the planning phase<\/a>, you will already have some structure and direction, so you will not be writing totally at random.<\/p>\n\n\n\n

Within that structure, however, don\u2019t write the way that you think a \u2018good blog\u2019 should be written. Instead, for each key point you need to elaborate on, try writing as though you were jotting down a reminder for yourself a year from now, or as though you were explaining this to a friend on an online forum. If necessary, close your eyes and imagine yourself in conversation with a friend, and write down what you would tell them to explain the key point in question, sentence by sentence. If this results in some clunky phrases or some obscure passages, that\u2019s fine \u2013 you can iron them out during the revision process<\/a>.<\/p>\n\n\n\n

Your entire first draft should be written in this manner. The formalism of writing will become second nature with practice, but at first it should be of little or no concern.<\/p>\n\n\n\n

The reason this approach is important is that regardless of whether the result looks good or not, it is going to be consistent<\/em>.<\/strong> You are not going to find yourself randomly changing your manner of writing from one paragraph to another, any more than you would do that for your manner of speaking.<\/p>\n\n\n\n

The resulting consistent voice will become the bedrock for you to build your style around. If you\u2019re wondering, for example, how to choose the right register for your blog, the answer is that it should adapt itself to your voice \u2013 and not the other way round.<\/p>\n\n\n\n

Finding and working with your voice is imperative for any writer. It will allow you to write much more quickly, because it will feel much easier than any other way, and it will give your writing a distinctive style that readers will learn to recognize.<\/p>\n\n\n\n

Your voice will become more flexible over time, giving your style a broader range. But before anything else you have to find<\/em> it, and you\u2019ll know you\u2019ve done that simply when you feel truly comfortable writing.<\/p>\n\n\n\n

4. Vocabulary<\/em><\/h3>\n\n\n\n
  • Can I use difficult, obscure words in a tech blog?<\/em><\/li><\/ul>\n\n\n\n

    The consensus when it comes to vocabulary is that the best thing you can do is to keep it simple, and avoid obscure or long words if at all possible.<\/p>\n\n\n\n

    \"A
    Adobe Stock \/ Vlorzor<\/figcaption><\/figure>\n\n\n\n

    This is great advice\u2026 for beginners<\/em>. If your level of English is not very high, then that\u2019s absolutely what you should do.<\/p>\n\n\n\n

    Once you reach a certain level of ability, however, words that would generally be considered recondite can actually become precise, and even elegant. For instance, the sentence \u2018he had the courage and the arrogance to call himself the team\u2019s only good developer<\/em>\u2019 becomes simpler and more precise by saying \u2018he had the audacity<\/strong> to call himself the team\u2019s only good developer\u2019.<\/em><\/p>\n\n\n\n

    Does that sound too easy? Fine, then up the difficulty level a bit. Try changing \u2018My career in tech has been unpredictable, chaotic, and not very easy to make sense of<\/em>\u2019 to the far more concise \u2018My career in tech has been vagarious<\/strong><\/em>\u2019.<\/p>\n\n\n\n

    The key is not to avoid difficult vocabulary, but to not exaggerate in its use.<\/strong> Expecting your readers to look up a word once or twice while reading your article is usually not unreasonable (in fact this is precisely how reading expands people\u2019s vocabulary). Anything more than that is too much, and will do more to detract from than to enrich the reading experience.<\/p>\n\n\n\n

    The only type of words you should definitely avoid are those which are not (just) difficult, but archaic<\/em>. For example, the reason you can\u2019t use \u2018erelong\u2019 instead of \u2018soon\u2019 is not that the word is difficult, but the fact that in common use it has gone extinct, and as such it makes your language less rather than more precise, clumsier rather than more elegant. If you are uncertain, look the word up in the dictionary \u2013 the entry will usually specify if it has become obsolete.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    All in all, a broader vocabulary increases the flexibility and the range of your style, and is an excellent weapon to add to your writing arsenal (in the field of tech writing, a fairly rare one too). You will occasionally misuse a word and confuse, say, \u2018meritorious\u2019 with \u2018meretricious\u2019, but hey, that\u2019s how you learn!<\/p>\n\n\n\n

    • Can I use slang, swear words and emojis in a tech blog?<\/em><\/li><\/ul>\n\n\n\n

      Yes, yes, and\u2026 maybe. If this is your natural writing voice, then that is how you should write, as long as you make sure that the register of your blog is consistent throughout.<\/p>\n\n\n\n

      A couple of caveats though. Firstly, swearing in your articles risks narrowing your readership. It\u2019s often surprisingly easy to excise obscenity from a sentence without compromising your voice for that, and there are plenty of words that can convey the same meaning and effect as expletives without putting off certain readers in the same way. Just something you might want to consider.<\/p>\n\n\n\n

      Secondly, slang does not mean \u2018bad English\u2019. If you want to write \u2018gonna\u2019 instead of \u2018going to\u2019, that\u2019s fine. If you write \u2018should of\u2019 instead of \u2018should have\u2019, that\u2019s not slang, it\u2019s just wrong, wrong, wrong. Never use slang, colloquialisms, casual speech or whatever to justify errors in grammar or spelling. <\/strong>Getting the latter things right is at the very heart of good writing and there is no room for compromise on that.<\/p>\n\n\n\n

      As for emojis, they still haven\u2019t entered common usage outside of chats and social media, and generally I would recommend avoiding them if possible. They are certainly incompatible with anything but the most casual, informal register, and more importantly, getting used to writing with emojis will slowly make it harder to write without them.<\/p>\n\n\n\n

      That said, times are changing rapidly, and many readers in tech nowadays may not be bothered by emojis. If you really want to use them, then don\u2019t let me stop you!<\/p>\n","protected":false},"excerpt":{"rendered":"

      The third article in our series on how to write better blog posts<\/p>\n","protected":false},"author":17,"featured_media":26683,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"content-type":"","footnotes":""},"categories":[42],"tags":[],"class_list":["post-26680","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\/26680","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=26680"}],"version-history":[{"count":1,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/posts\/26680\/revisions"}],"predecessor-version":[{"id":62573,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/posts\/26680\/revisions\/62573"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/media\/26683"}],"wp:attachment":[{"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/media?parent=26680"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/categories?post=26680"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wbscodingschool.com\/de\/wp-json\/wp\/v2\/tags?post=26680"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}