Writing

| View comments on Hacker News

Writing is hard. You’re condensing your thoughts into more general concepts that can (hopefully) be understood by others. It’s equivalent to compressing a giant file (your mind) into some smaller artifact (some scribbles on a page).

Writing is valuable. It’s how we can give the gift of knowledge to the future. One can learn some concept and teach it to others with no investment other than the time spent compressing that knowledge.

Writing is introspective and philosophical. Writing delves into the nature of knowledge. What’s worth sharing with others?

The process of writing is good practice for thinking. It forces you to focus on communicating clearly. It makes you think about language and how to effectively convey concepts. It makes you consider if your examples are truly clear and engaging, or just a distraction not adding any value.

I’m really bad at writing. My thoughts are chaotic and disorganized and hard to communicate. Praciting writing gives me the chance to hone what I’ve been thinking about, and work “muscles” to help me communicate more clearly.

Recent posts from blogs that I like

Naturalists: Naturalism and Impressionism

A spectrum of purposes and styles, inspired by Émile Zola's experimental approach to novels, documenting ordinary people with objectivity, in a neutral realism.

via The Eclectic Light Company

On the compulsion to make art

The work was what connected him to himself.

via Henrik Karlsson

Notes on clarifying man pages

Hello! After spending some time working on the Git man pages last year, I’ve been thinking a little more about what makes a good man page. I’ve spent a lot of time writing cheat sheets for tools (tcpdump, git, dig, etc) which have a man page as their primary documentation. This is because I often fi...

via Julia Evans