Path: csiph.com!x330-a1.tempe.blueboxinc.net!newsfeed.hal-mli.net!feeder3.hal-mli.net!newsfeed.hal-mli.net!feeder1.hal-mli.net!border3.nntp.dca.giganews.com!Xl.tags.giganews.com!border1.nntp.dca.giganews.com!nntp.giganews.com!local2.nntp.dca.giganews.com!nntp.earthlink.com!news.earthlink.com.POSTED!not-for-mail
NNTP-Posting-Date: Sun, 27 Nov 2011 10:40:04 -0600
Date: Sun, 27 Nov 2011 08:39:55 -0800
From: Patricia Shanahan <pats@acm.org>
User-Agent: Mozilla/5.0 (Windows NT 5.2; WOW64; rv:8.0) Gecko/20111105 Thunderbird/8.0
MIME-Version: 1.0
Newsgroups: comp.lang.java.programmer
Subject: Re: Standard Design and Development Methodologies
References: <Xns9FA29593FF4C2jpnasty@94.75.214.39> <qnrjc79pn9lejv4tkqjcdo9tpfb861ebvj@4ax.com> <zdqyq.44013$jK1.28052@newsfe17.iad> <9j25r6FpfU1@mid.individual.net> <jagtl2$e0n$1@dont-email.me> <vFWyq.58884$rF5.53626@newsfe19.iad> <4ed05727$0$289$14726298@news.sunsite.dk> <avh3d7h90306idj3v7qedci95d1tvi0ds4@4ax.com> <j7qAq.12566$Uq2.9347@newsfe05.iad>
In-Reply-To: <j7qAq.12566$Uq2.9347@newsfe05.iad>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Message-ID: <SP2dnXWgKcJ5-k_TnZ2dnUVZ_rydnZ2d@earthlink.com>
Lines: 11
X-Usenet-Provider: http://www.giganews.com
NNTP-Posting-Host: 70.230.194.31
X-Trace: sv3-xSqptO+iyXGZVKGm1GhWbL4kY/6uSQiQ0DsLrn75m2age4Dxh1qwnofIXSR2496G4yzGUh/BP+pw+eG!JCN1DklEiFgC0lP3j0ezUbeOoYs15aUgiN8rpPRJwZnMiYSFqbjTjTjCDjGAkNo0xFv98F+Vm48w!0FwX6WPQVzegVhLPFyiok/VTKo95Vg5LDsupwOA0F+D5bA==
X-Abuse-and-DMCA-Info: Please be sure to forward a copy of ALL headers
X-Abuse-and-DMCA-Info: Otherwise we will be unable to process your complaint properly
X-Postfilter: 1.3.40
X-Original-Bytes: 1877
Xref: x330-a1.tempe.blueboxinc.net comp.lang.java.programmer:10279

On 11/27/2011 4:34 AM, Arved Sandstrom wrote:
...
> The only thing that stays with the code - reliably - *is* the code,
> including comments.

This is one of the reasons I love Javadoc, and similar systems. A
comment block right next to the thing it describes stays with the code,
and is more likely to get updated during maintenance than any other form
of documentation.

Patricia