I noticed reading some of the comments here that they don't get into what a "good" comment is. Many critiques on HN will try to identify best practices, but wit

I noticed reading some of the comments here that they don't get into what a "good" comment is. Many critiques on HN will try to identify best practices, but with comments, and writing generally, it's more a skill you have to learn. The weirdness you mention can be explained, I think, by the fact that the project has a single contributor.[1] A person learns which patterns work or not when patterns clearly work or fail. Since bad comments are something that affects maintenance without breaking the code, it wouldn't be surprising if the internals are solid while the code is less maintainable. And I predict that if it takes off, you'd see other contributors pushing back against the extraneous comments, and Abhishek's style in commenting evolve. [1]: https://github.com/abhiTronix/vidgear/graphs/contributors https://github.com/abhiTronix/vidgear/graphs/contributors