Methods as Comments (Re: Mixing OO and DB)

From: topmind <topmind_at_technologist.com>
Date: Mon, 3 Mar 2008 09:36:55 -0800 (PST)
Message-ID: <8ca4f7af-3b60-4650-9760-9ccb1e0a0e5a_at_e25g2000prg.googlegroups.com>


Robert Martin wrote:
> On 2008-02-29 13:29:11 -0600, topmind <topmind_at_technologist.com> said:
>
> > Wrapping merely for *documentation* purposes is poor
> > form. We have *comments* for those:
> >
> > // retrieve portfolio
> > pf = query("select x from foo where.....");
>
> On the contrary, wrapping for documentation purposes is _very good_
> form. Comments are a rather poor substitute.

I vehemently disagree. Method/functions used as mere comments is a recipe for code cluttered with way too many methods/functions. I don't know how your eyes and brain and fingers work, but I do not like that code style whatsoever. It would slow me down. It is bureaucratic and anti-KISS.

> --
> Robert C. Martin (Uncle Bob)��| email: unclebob_at_objectmentor.com
> Object Mentor Inc.� � � � � ��| blog:��www.butunclebob.com

-T- Received on Mon Mar 03 2008 - 18:36:55 CET

Original text of this message