Path: utzoo!utgpu!news-server.csri.toronto.edu!rpi!usc!elroy.jpl.nasa.gov!decwrl!netcomsv!jls From: jls@netcom.COM (Jim Showalter) Newsgroups: comp.object Subject: Re: Comments (was Re: Functions without side effects (was Old confusion)) Message-ID: <1991Jun24.200650.13445@netcom.COM> Date: 24 Jun 91 20:06:50 GMT References: <1991Jun21.013944.23970@netcom.COM> <1991Jun23.025529.7749@netcom.COM> <1064@dumbcat.sf.ca.us> Organization: Netcom - Online Communication Services UNIX System {408 241-9760 guest} Lines: 14 >However, comments that explain _why_ something is >being done can aid understanding. We're in violent agreement. When I said I regarded most comments as superfluous, I was talking about the paraphrasing comments and the comments that work around missing language features. I completely agree with you that design comments are valuable. Sadly, these are the minority of comments in much of the code that is inflicted on me. -- *** LIMITLESS SOFTWARE, Inc: Jim Showalter, jls@netcom.com, (408) 243-0630 **** *Proven solutions to software problems. Consulting and training on all aspects* *of software development. Management/process/methodology. Architecture/design/* *reuse. Quality/productivity. Risk reduction. EFFECTIVE OO usage. Ada/C++. *