On Thu, 18 Dec 2025 18:00:45 +0000, Richard Kettlewell wrote: > I’ve also encountered quite a few comments written by people who had > been instructed to add comments to under-commented code, but didn’t > really understand what they were looking at. The result generally > obscures more than it illuminates.
Many of the comments were by recent graduates/interns who had received 'Thou Shalt Comment' as the 11th commandment. Ironically when a TA at the university who was known to demand extensive commenting was hired we found he never commented anything, preferred cryptic variable names not to exceed three characters, and did perverted things with the macro processor so function names were patched together on the fly rather than existing in the code. Then there was the fondness for the big hairy bison to create private little languages. -- https://mail.python.org/mailman3//lists/python-list.python.org
