Then you must have been very lucky, I have seen it happening probably hundreds of times in a mere 15 years on the job.
The inconsistencies that I experienced ranged from doc strings stating to pass a parameter that didn’t exist any more, parameters with different names, parameters with the correct names but in different orders.
As per actual comment I have seen plenty of time comments like //here we go baby!
//do not touch!
//1 ... //2 ... //3 .. //8
The last one apparently was to indicate the order of some overengineered stuff that could have been written properly.//This happens only for CompletedOrders (while in reality it was the opposite) //This calculates the notional in the same currency (while it was converting it in GBP) //This is extremely important, never delete (and after that there was a bunch of commented code) Honestly I don’t remember all of them, I tend to use my memory for more important things, but I bet that if you had seen only 1/10 of the bad comments that I have encountered you would have a different opinion.
Btw in your post you are explaining exactly why I hate comments: “For me personally they often helped compensate sloppy code” - the solution is obviously to fix the sloppy code, not to write a comment because you are too lazy to fix it “(non-obvious) assumptions” - this is probably the only legitimate reason to write a comment. “and prevented bad solutions because I reconsidered while writing (embarrassing) comments.” - this has nothing to do with the comments given that at the end you didn’t write it. Thinking more about the code instead of trying to comment it gives you the same result, if not even better. |
> “(non-obvious) assumptions” - this is probably the only legitimate reason to write a comment.
If that's what you think, I rest my case...