[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
- From: "Bullard, Claude L (Len)" <firstname.lastname@example.org>
- To: Danny Ayers <email@example.com>, The Deviants <firstname.lastname@example.org>
- 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
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.
Ekam sat.h, Vipraah bahudhaa vadanti.
Daamyata. Datta. Dayadhvam.h
From: Danny Ayers [mailto:email@example.com]
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.