All posts by Tor Håkon Haugen

Writing Tips

Twice I have been fortunate enough to have one of my posts featured on Hacker News. Well, fortunate might be a strong word because the attention comes with a price.

The first post was a tongue-in-cheek essay about digital natives and boy did it get some attention. Mostly negative. HN is a lovely community, but reading those comments were not an enjoyable experience.

This brings me to my first tip: Humor can easily get lost in translation. I’m not saying you shouldn’t use it, but you should be aware that humor – especially irony and sarcasm – doesn’t translate well into writing.

In my second post, Writing is Hard, I wrote about what I find difficult about the writing process, and what I believe is the best way to solve it. This time the comments were far nicer, and I enjoyed reading them. There were different opinions, obviously, but the general tone was much better and the feedback more constructive – which I attribute to the fact that I wrote a more constructive essay as well.

I could say: Write more constructive, but I don’t think it’s a constructive advice. Instead, my second tip would be: Keep your promise to the reader. This applies even if you think nobody will read it; if you promise something in the title or the beginning of the text, follow up on that. In my first draft, the title of this essay was “Writing Tips”. So now I must either deliver on that or change the title.

This brings me to my third tip: Change your title accordingly. Sometimes the title is clear from the start, but usually the title is just a placeholder until you know what the text is about. Writing can be an evolving process; in some cases, you don’t know the text until after you have written it and done the first round of editing.

As mentioned, I find much joy in the HN community, and I’ve noticed that people often want evidence. This is a good thing; It means people are paying attention. So, if you claim something, make sure to back it up. This is not a hard rule; I just broke it myself claiming that people on HN want more evidence.

Speak the truth and be honest with your reader. I don’t mean that you shouldn’t write fictional stories or fairy tales, but if you try to sell something; be upfront about it.

English is not my first language, but I believe I can use that to my advantage by keeping it simple and make the text readable. I don’t try to impress with words I don’t understand, and neither should you.

Equally important, no matter how simple words you use: Fix spelling and grammar. Our brain is incredible when it comes to filling in the gaps. One way to fix spelling is to read the text backwards, word for word. But I’m lazy and just copy the whole thing into Microsoft Word and let it advice me.

Still, weirdness can get through. In the original draft I managed to write “thong-in-cheek” instead of “tongue-in-cheek” – now that will certainly conjure up an image in your head. Both will pass the spellchecker; but one is not like the other.

Once you have written your piece; let it mellow for a while. I know it’s tempting to press the publish button, or in other ways release it to the world, but let it rest. As with tasty food, the flavors must get to know each other. I think this applies to words and sentences as well. If they taste sour when you get back to them after a few hours, or a few days, re-write or throw them out.

The written word doesn’t have an expiration date; it won’t go bad, but it won’t get any better either. Make sure your text is tasty before you serve it to other people.

I want to finish with this: We all make mistakes. It’s not the end of the world if you make a typo or two, as long as the text is readable, understandable and you get your point across.

To summarize:

  1. Be careful with humor, especially with irony and sarcasm
  2. Keep your promise to the reader
  3. Change your title (if necessary) once the text is ready
  4. Backup your claims with facts and references
  5. Speak the truth and be honest with your reader
  6. Keep the language simple, avoid using words you don’t fully understand
  7. Fix spelling and grammar
  8. Let your text mellow and re-read before you publish

So, there you have it: My writing tips. They may not be perfect, but I didn’t promise that either, so I believe I have delivered according to my own advice on this one. Now, what are you waiting for? Start writing.

Writing is hard

Writing is hard. Especially if you start thinking. Never stop to think about what to write (unless you must), it will ruin the flow. Never stop to correct yourself, to judge or run a spellcheck. Don’t do that; that’s what editing is for.

I’ve read the same tips again and again: Write first, edit later. The first draft is for you, the second is for everyone else (or just an editor or a confidante). Don’t interrupt the flow. If you need to look something up, place a marker in the text and look it up later.

That’s why I love to journal using pen and paper. You only have one direction: forward. Get the words down on the page in the order they appear in your head and move on with your day.

Breaking the flow has been one of my biggest issues when it comes to writing, both at school and later in life. I always ended up fiddling with the text before I got all the ideas out of my head. Looking up words, finding reference material (blog posts, news articles), checking facts. Don’t do that either. Checking facts is a part of the editing process.

In school I could spend half an hour playing with WordArt (remember WordArt?) for the title alone. The title can wait, you may want to change it anyway.

Another mistake I’ve made is installing a SEO plugin for WordPress and trying to make it happy. It has tips that make sense for readability: Use active words instead of passive. However, most of the tips are there to transform your style into something it’s not – someone else’s.

Add an image. Add a key phrase. Repeat the phase repeatedly throughout the text. Shorten your paragraphs. Add subheadings. Add more outbound links (but don’t forget internal links!).

Forget about SEO. That’s not part of the game, if it is: you’re not writing for yourself anymore. Don’t let anyone dictate your style; find your own voice. If you need pointers on style: read a book, then read some more.

Once you run out of steam; you’re most likely done. Take a break. If nothing new pops up in your head, you can start the editing process. If you thought writing was hard, wait till you start editing. Editing is hard.

Russia invaded Ukraine

This is not a regular blog post, it is just me stating a fact, since Russia has started blocking all external news sources, maybe this page will still be visible. Russia invaded Ukraine. Russia went to war with Ukraine. And Vladimir Putin is a war criminal.

This is not the fault of the Russian people — maybe other than their acceptance of keeping an autocrat in power for over 20 years. Healthy democracy needs new blood and new ideas.

If you are a russian living in Russia, ask yourself: What are the government trying to hide from you by blocking more and more social platforms? Why have they created new laws to punish those who try to voice their concern?

The flag of Ukraine

Reading goals for 2022

2021 started of well. Very well indeed. Life was good and I was happy. That did not last. None of this had anything to do with Covid-19 or any other illnesses, except for anxiety, I guess. Anyways, now that I have completed the seasonal greetings of the new year, I want to write a bit about my reading.

Some of the books I read in 2021

In 2020 I hade a goal of reading 12 books in a year. Since it was my first year setting such a goal, I figured one book per month was as good as any. By the end of the year, I reached 15.

In 2021 I decided to double that goal, 24 books in 12 months. A hairy target, giving my taste in books (mostly memoirs, biographies, and other non-fiction literature), but goals should be aspirational, but also within reach. At the end I managed 30 books. I really managed to push through at the end of the year. Also, I tend to read more than one book at a time. More about that in a bit.

Now this year — the year 2022 in case you missed it — the goal is to read 36 books. Combined with slightly faster reading speed, and a solid reading habit each day, I think that should be doable. There, I have said it: 36 books by the end of the year.

The goal to read 36 books is not just about reading as many books as possible. That would be a waste of time. The goal is to absorb the books. To enjoy them and to learn. Most of the books I read, as said earlier, is memoirs, biographies, and other non-fiction work. This generally takes more time to digest then pure fiction.

My reading strategy now is to read more than one book at a time. Typically, this means one biography/memoir, one other non-fiction book and one pure fictional book to seek refugee in when my brain needs a time off from all the facts and figures in the other books. Also, to my benefit, I can read both Norwegian and English books, which gives me yet another dimension in my reading. I do not have any issues reading a biography in English and another in Norwegian at the same time.

Usually, I read a mix of physical books and digital on my Kindle. I love books on paper, but the Kindle is so much more versatile when traveling (not happening much in Covid times) or in bed. I rather swipe on my Kindle than on my phone — the Kindle is so much better for the eyes.

If you really would like to know what I am reading, I have a Goodreads profile — here is the books I read in 2021 — otherwise I would probably not log my readings at all.

My first contact with Linux

I remember it like it was yesterday. The thrill. Wandering away from the safe and boring, and into the unknown. Yes, I’m talking about my first installation of Linux, Slackware 4.0 – which places my first contact around mid 1999, since this year also saw the 7.0 release.

Unfortunately, I don’t remember the name of the guy who introduced me, or his handle on the internet. It was at the local computer club, and in a short evening he showed me the ropes, helped me install Slackware and recommended using Enlightenment (E16) instead of Gnome or KDE.

The Librarian

Before this point, I’ve already read skimmed through at least one book on Linux, which is almost a short story in itself. I got curious about this whole Unix thing a few years earlier and took a trip down to my local library to see what they had on the topic. I asked the lady at the desk, but she didn’t know what I was talking about, however, the guy with the “stuffed penguin doll” certainly did.

Yet another guy I don’t remember the name of, but who made a lasting impression. “You don’t want Unix, you want Linux. Take this book, it will answer all your questions and make you wise” – well, the first part of that sentence is true anyway. So, it turns out that one of the librarians was a Linux geek! And when he spoke about his weekend Linux adventures at work, no one understood a damn thing. But I got it. I understood. At least I understood the core concept, I did not understand how much work it was to save a RAID gone bad. That would come later.

Got root?

So, I mentioned the thrill earlier, and in hindsight this might seem silly, but the thrill of being root for the first time was more powerful than you probably can imagine. This feeling quickly faded though, since I was root only on my own machine, but still, it felt big at that moment.

Back in 1999, you could not just install Linux and expect everything to work out of the box. Just setting up the graphical environment required a lot of leg work. Like knowing the vsync and hsync of your monitor (CRT monitors, remember those?), screen resolution, colour depth and a few other bits and pieces. If you got it wrong, it would just flicker your screen and crash. Fun times, glad they are over.

The Linux kernel

At some point I started compiling my own kernels. Adding and removing features to make it as small and streamlined as possible, and yet still be able to boot. I learned a lot about hardware back then, well, a lot about which hardware I had at least. Also, I learned how long it took to compile the kernel on my machine. It was just long enough that you didn’t want to make too many mistakes. So, circa 20 minutes?

Looking back, I’m glad most distros shipped with the source code as well as the compiled binaries. Downloading a new kernel took ages, that is around 38 minutes assuming we download a 17MB .gz file on a 64 Kbps (ISDN) connection.

Dial Internet

Eventually, we got internet, dial-up of course, but probably not the one you are thinking about, unless you made the connection from the previous paragraph. If you did, kudos. Anyway, my parents went straight to ISDN, two lines, always on. Except I wasn’t always on, because dial-up still cost money by the minute.

I had an Teles ISDN card where IRQ address had to be set manually (ISA bus), luckily there was a German project (German domain at least) called ISDN4Linux which helped a lot when setting up the correct kernel modules and software config. I guess ISDN was more of a European thing.

A funny thing about this ISDN card – well, funny might not be the right word – from time to time, the card would stop working. Rebooting the machine did not help. However, changing the ISA slot did. So, each time it stopped it was just a matter of turning the machine off, moving the card between one of the ISA slots available, and power it back up. Yeah, that was not a funny thing. I should not have written that.

I don’t know if anyone else ever had that problem, but the solution, as I mentioned, was easy. And as long as I never put the lid back on, or fastened the screw securing the card, it was a quick and painless experience. Except for the part were the machine had to be powered off and back on. Okay, skip quick and painless, let’s say: easy but tedious.

The year of the Desktop

Despite a lot of talk about “the year of the desktop”, it never really happened for Linux. Well, it happened for me. I used Linux full time on my desktop for over a year and a half around 2004. It was good and it felt good. I was master of my domain, still rocking Enlightenment as my go-to desktop environment.

Linux and Enlightenment with XMMS, gkrellm and a few other applications running
XMMS and gkrellm, those were the days.

Picture above: If you read Norwegian, I did eventually get paid for that Windows XP stint. If you don’t read Norwegain, I still got paid.

Now, however, I was using Gentoo. A Linux distribution that was compiled for your hardware on your hardware, promising more speed and control. The speed gain would come after installation and certainly not during, because downloading and compiling every package took ages – and this time I’m not talking about 38 minutes anymore, but hours.

I did save a bit of time when I worked as a sysadmin at a school. Using computers in the computer lab and a boot disk, I could harvest their collective processing power to install Gentoo on my laptop using distcc, a distributed C/C++ compiler system. Also, the school had way faster internet then I had at my apartment.

Then games drew me back to Windows. Now days it’s mostly Lightroom keeping me back, but the way Windows is heading, Linux as desktop looks way more interesting again. I’m still using Windows 8.1 at home, and it’s not because it’s great.

What’s this all about then?

I learned so much about computers back then, and Linux really was a big driver in that regard. Do I miss it? I would be lying if I said no, but on the other hand, my previous rant post have showed me that this probably is more about nostalgia then anything else.

I guess that’s basically it: me dipping my toes in lake nostalgia, again.