filkerdave is a user on octodon.social. You can follow them or interact with them if you have an account anywhere in the fediverse.
If you don't, you can sign up here.
"don't write comments, just write clear code" yeah and also write comments
@jk Any engineer who tells you that well-written code is self-documenting has failed to understand the question: code can only tell you _what_ it is doing. It cannot tell you _why_. It cannot answer the fundamental question "what made this design the right choice, as opposed to any other implementation, based on the constraints that existed when we wrote it?" As such, even the best-written code cannot truly "self-document."
@literorrery @jk Anyone who tells you that well-written code is self-documenting is lying to you.
The real test of well-documented code is when you can pick it up in 6 months and say, "Oh, yeah, *that's* why I did this!"
