Writing a Good Design Document

grantslatton.com

This essay is a version of the response I gave to my friend Vik’s call for suggestions: had a lot of people ask how they can learn to write design docs, and i didn’t have a good answer besides “work … Read more

Writing a basic service for GNU Guix

tannerhoelzel.com

According to the Shepherd Services documentation, the start and stop fields of shepherd-service take G-Expressions. But what’s a g-expression? Well, because Guix uses Scheme for both higher-level actions–like defining packages–and lower-level actions–like building derivations generated by packages– it needs a … Read more

Writing is thinking

nature.com
writing-is-thinking

On the value of human-generated scientific writing in the age of large-language models. Writing scientific articles is an integral part of the scientific method and common practice to communicate research findings. However, writing is not only about reporting results; it … Read more

Writing Code Was Never the Bottleneck

ordep.dev

For years, I’ve felt that writing lines of code was never the bottleneck in software engineering. The actual bottlenecks were, and still are, code reviews, knowledge transfer through mentoring and pairing, testing, debugging, and the human overhead of coordination and … Read more

Writing Toy Software Is a Joy

blog.jsbarretto.com
writing-toy-software-is-a-joy

Why you should write more toy programs I am a huge fan of Richard Feyman’s famous quote: “What I cannot create, I do not understand” I think it’s brilliant, and it remains true across many fields (if you’re willing to … Read more