3 ms·
You wouldn’t be able to contribute to the Redis or SQLite codebases, then, as they are heavily and helpfully commented and are almost always near the top of the
by christophilus 8y ago
You wouldn’t be able to contribute to the Redis or SQLite codebases, then, as they are heavily and helpfully commented and are almost always near the top of the list of answers when people ask the question: “What are some examples of exemplary codebases?”
In fact, it was reading those projects and then returning to my workplace’s uncommented source that convinced me to change my philosophy on commenting.
- kungtotte 8y agoI just looked up a sample of the SQLite codebase[0] and it seems to align with what most people are saying here, to keep a minimal amount of comments and the ones that are there should comment what the code can't tell you. [0] https://sqlite.org/src/fdiff?v1=7c288b4ce309b5a8&v2=8efa2c813b3f6a83 https://sqlite.org/src/fdiff?v1=7c288b4ce309b5a8&v2=8efa2c81...
- diminoten 8y agoThe SQLite project is a good example of a codebase despite this decision, not because of it. SQLite is nearly 20 years old, and their position on this topic is reflected in their policy. And Redis makes no such requirement. You are wrong.