Writing

Writing forces clarity. When I explain a concept to others - in a doc, a talk, a code review comment, even just chatting with AI - I discover the gaps in my own understanding. The act of making something legible to someone else makes it more legible to me. – Addy Osmani in 21 Lessons From 14 Years at Google The one quoted above is #12, and I’ve been religiously abiding by it for a long time, but all 21 are well worth reading. If you’ve been in software engineering long enough, they’ll resonate with you. Also, most lessons apply to all kinds of career paths, not just software. ...

As AI generated content becomes the norm, I believe that human-generated content and raw thoughts and emotion will become more valuable. In many ways, I’d rather read a raw, unproduced, and scrappy blog post with grammatical mistakes over perfectly generated content that serves little value. – Armeet Singh Jatyani, Importance of Writing

I think of it [the usefulness of writing] like breathing but for ideas. We do so much reading all day—there should be a natural balance with producing words too. Inhale, exhale, inhale, exhale… Joe Boudreau in On 10 Years of Writing a Blog Nobody Reads, an article I agree 100% with.

Write a lot. This is alpha and omega of writing advice, the beginning and the end, and it’s that way for a reason– I don’t know anyone who’s good writing who hasn’t also put in serious hours. – Nat Bennet

I find, more often than not, that I understand something much less well when I sit down to write about it than when I’m thinking about it in the shower. In fact, I find that I change my own mind on things a lot when I try write them down. It really is a powerful tool for finding clarity in your own mind. Once you have clarity in your own mind, you’re much more able to explain it to others. ...

My brilliant friend Salvatore Sanfilippo (otherwise known as antirez of Redis fame) has an interesting write-up on his website. How similar is programming to prose writing? After getting his own feet wet with novel writing, he is convinced that the two activities share many common traits. One year ago I paused my programming life and started writing a novel, with the illusion that my new activity was deeply different than the previous one. A river of words later, written but more often rewritten, I’m pretty sure of the contrary: programming big systems and writing novels have many common traits and similar processes. ...