4 ms·
If it has lots of comments, it’s probably buggy
- tobylane 15y agoI'm not a heavy commenter, mostly because I'm yet to work in a team, but there are many reasons to comment a lot. Sometimes the whole readme for something like a javascript library api is the file header. Maybe you want to make clear what you've started/done incase others are allowed to edit it (though if you have to point some things out you shortened too much).
- ezyang 15y agoYes, I don't think Byron was knocking API documentation in the form of comments. My interpretation is that when someone edits clever code they don't understand fully, they tend to add lots of comments—and that (not the comments) is absolutely asking for lots of bugs.