“Coding for humans: Best practices for writing software people can read”
Statistical Modeling, Causal Inference, and Social Science 2026-01-17
Bob Carpenter pointed me to this wonderful presentation by Jeff Soules.
Or if you just want to read the slides, they’re right here.
These slides are just full of great advice. Here are the sections of the presentation: – Human-readable? – The barrier to readability – Naming things – Comments and documentation – Writing better functions – Practices outside code
I recommend you read the whole thing. It will likely improve your work and, if not, it’s still enjoyable to read and will make you think.