Writing is a habit. It takes a lot of practice to get good at and as with every discipline, if you don't use it, you lose it.

It's still a little weird for me to think of myself as a writer. I'm a technical guy. I've been obsessed with computers since I was 8 years old. I've been programming since I was 9. I've been paid for providing programming services for over 20 years.

Yet looking back, it's obvious that writing was a big part of what I was doing. Explaining what needs to be done or how I did something, turned out to have value. I was a math major and writing up proofs is essentially that, it's explaining why something is true in a step-by-step, logical way. This is why so many math and physics people eventually find their place in industry as programmers.

There's also the advent of email, which came at the right time for me. I was in college when the World Wide Web exploded, in 1994. Around that time, the big thing for everyone was email, how you could send letters to people quickly and efficiently. No more waiting for a week or more to receive a reply from someone. I was an email junkie, keeping up with high school friends and writing letters to other people I had kept in touch with. Email for a few years there was a real repository of good letter writing.

Even coding itself was a form of writing. There's beauty in it if you care to look. One of my good friends, Ken Liu is an amazing coder and also an amazing writer. There's something about crafting words that lends itself to a creativity found in coding.

And yes, there is documentation, which unfortunately is very lacking in most programming environments. But the actual code writing really is a form of explaining. It's just to a computer and not to another human being.

In a way, the practice of coding, of being precise about your instructions, carries over to writing. Of course, English isn't nearly as precise as Rust, but we should still be as clear as possible. Perhaps this is why I focus so much on clarity in my writing, rather than in ideas that can be interpreted many different ways.

Still, try as I might, people interpret my writing in their own way. It's like we have different execution environments that we call our brains and the words will never execute quite the same way.

Writing to people helps me see the different ways in which people interpret my words and I can use that to debug my writing, which hopefully improves as a result over time. People are not just execution environments of my writing, but also test harnesses. And Twitter/Nostr are ways to unit test different snippets.

Writing helps coding and vice versa. Even in that last sentence I thought about saying instead "writing helps coding and coding helps writing." Which is clearer? Are there some non-English speakers that maybe don't understand "vice versa"? Does the latter flow a little better on the tongue? Is the user experience better on the former?

I write because I want to improve my craft, both as a writer and a coder.

Reply to this note

Please Login to reply.

Discussion

Reading books will be a huge challenge for the young generation who are developing TikTok brain.. the lack of focus will transition to other aspects of life as well, fitness, job performance ect..

Very true!

Embrace the fact. Our children don't even need any kind of degree any more in order to compete in the job market. They only need above average attention span. Easily achievable via good parenting.

Same here. Always preferred coding to writing. Now challenging myself to write more as it has potential to promote my ideas and software projects reducing the need for a dedicated marketing/sales team.

They are all about taking the ideas in your mind and to manifest them in reality

Writing is a super power. It allows you to influence and convince many others with your thoughts and ideas. The pen is indeed mightier.

Never stop Jimmy. You make a bigger impact than you realise!

I’ve enjoyed using my coding tools for creative script writing: vs code, markdown, snippets, git (including branching!), regex, pandoc. I couldn’t use Word now!

Love this, Jimmy!

I would argue that while coding is primarily explaining to a computer, it is also explaining to other coders. If you neglect to keep it understandable to other humans, you’ll be the only person who can read and maintain your code, and nobody will want to work with it.

If I could be so brave as to suggest another aspect. When we code, it’s so rewarding. The process of creating nourishes the soul. But it still lacks something: We haven’t connected meaningfully with other human beings. Writing to humans rather than computers fills a part that can’t be filled any other way.