I hope that he spends some of his time not commenting to fix his js so that it doesn't take 90 seconds to scroll down the page
Don't waste your time commenting source code
21–25 of 25 posts
Re: Don't waste your time commenting source code
#22Maybe one reason to encourage comments in source code is not to waste the time of good programmers who write clear code, but to help everyone who has to deal with unclear code written by not-so-good programmers.
Re: Don't waste your time commenting source code
#23Earlier quoted context omitted.
Exactly. There isn't a programming language in the world, and never will be, that can explain the WHY of the code being written. I write tons of comments explaining WHY I'm doing things so that 1) I can understand what I did when I come back to the code and 2) Other people can understand what I was thinking and how the code fits into the greater whole. I HATE code with no comments. And tests are not sufficient docume…
I've worked with a lot of legacy code over the years. I don't usually care whether code has comments or not. Comments are a very poor way of expressing semantics in code. Usually, I'm looking for general readability and understandability. I'd much rather see short, well-named classes and methods, well-named variables and good unit tests before I see a single comment. In the absence of clean, readable code, comments a…
I've worked with a lot of legacy code over the years. I don't usually care whether code has comments or not. Comments are a very poor way of expressing semantics in code.
When working with legacy code that is not commented, how do you determine the invariants of an API?
That is, how do you ensure that the change you're making will not break other code? Do you have to scan the entire project, and any other projects that depend on it?
Unit tests are often not sufficient here -- changing the invariants of an API may not result in deterministic failure -- in fact, invariants often describe requirements necessary for deterministic behavior.
Re: Don't waste your time commenting source code
#24"A well-designed program uses classes and design patterns" Ha ha ... also don't waste your time asking me for a job.
The only zealot as bad as the patterns zealot is the anti-(patterns zealot). Which is of course, different from the (anti-patterns) zealot.
Even worse than that is the anti-(anti-(patterns zealot)).
Re: Don't waste your time commenting source code
#25My semi-humorous response: http://glassocean.net/riyad-mammadov-enterprise-architect-sa...