Jeff AtwoodJul 16, 2023
"Of all the cruel tricks in software engineering, this has to be the cruelest. Most of us entered this field because the machines are so much more logical than people. And yet, even when you're writing code explicitly intended for the machine, you're still writing for other people. Fallible, flawed, distracted human beings just like you. And that's the truly difficult part." https://blog.codinghorror.com/coding-its-just-writing/
Coding: It's Just Writing

In The Programming Aphorisms of Strunk and White, James Devlin does a typically excellent job of examining something I've been noticing myself over the last five years: The unexpected relationship between writing code and writing. There is perhaps no greater single reference on the topic of writing than Strunk and

Coding Horror
Show threadBartek Ogryczak

@codinghorror This is a great point.

I'd add to that if you're an experienced dev, your code still needs to be read _and understood_ by your teammates, who might be junior or new to the language, so nowadays I tend to write far simpler, longer code avoiding “neat tricks” of the language, even if it results in my code looking less “smart” and “idiomatic”. The same goes for technical writing, I'm avoiding idioms, colloquialisms, references etc, that non-native speakers might not understand.

Jul 16, 2023 at 9:26pmWeb