• 0 Posts
  • 12 Comments
Joined 3 years ago
cake
Cake day: July 20th, 2023

help-circle










  • When I was a newbie, the “self documenting code” screed made sense to me, but with experience I’ve come to learn the type of person that is likely to latch onto it and advocate for it writes the least maintainable code.

    Don’t make 80 character function names or change to structure of code to something worse to try to make it self documenting. Don’t write comments that are already obvious from the code. Don’t be shy about writing comments otherwise. Do update comments and ask people to update comments in PR feedback.

    Most of all, fuck writing less maintainable code to try to satisfy LLM agents.