[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

RE: Comments

• From: "Bullard, Claude L (Len)" <clbullar@i...>
• To: Danny Ayers <danny@p...>, The Deviants <xml-dev@l...>
• Date: Mon, 16 Apr 2001 13:56:59 -0500

A road is self-documenting.

You need to get to the airport BEFORE the 
flight leaves?  Oh, well, I have this map.  I authored 
it.  I published it.  I'll sell this to you.

A tax form is self-documenting.

Of course my neighbor's children 
are my dependants.  I mean, they eat here 
at least three times a week.  I am supporting 
them, right?

Lifeboats are eXtremely self-documenting?

Didn't you read the instructions?  I'm sorry 
but YOUR deck goes into the starboard...GLUG!

Whee.  Better than Haikus.

Len 
http://www.mp3.com/LenBullard

Ekam sat.h, Vipraah bahudhaa vadanti.
Daamyata. Datta. Dayadhvam.h


-----Original Message-----
From: Danny Ayers [mailto:danny@p...]


But what about the Xtreme view of good code being self-documenting? - if
your code needs comments then your naming/structuring is at fault. Ok, this
*is* the extreme case, but it's a reasonable point - you should be able to
tell what a thing is/how to use it/if it bites without needing a manual.

• Prev by Date: RE: Comments
• Next by Date: Re: Massive Cross-Post: The State of XML-RPC, April 2001
• Previous by thread: RE: Comments
• Next by thread: Re: validating schema parser
• Index(es):
  • Date
  • Thread