Posted by Jerry Stuckle on 07/08/07 01:16

Sanders Kaufman wrote:
> pangea33 wrote:
>
>> Any "professional" programmer who relies on the vast repository of
>> *documentation* present in most projects in industry is either an
>> idealistic novice, or EXTREMELY fortunate for the places they've
>> worked.
>
> Amen.
> I write from specs, I write my own code, and then I use my IDE's
> documentation utility to document it.
>
> STILL - I keep finding myself forgetting how my own functions are
> supposed to work.

I write from specs - which include function calls, etc. When I find a
function needs to change the doc changes with it.

And that's how I run the multi-programmer projects I manage, also.

No spec is perfect - there are going to be changes to it. But those
changes need to be documented, also.

The result is a set of doc not a lot unlike what PHP has for their doc.

--
==================
Remove the "x" from my email address
Jerry Stuckle
JDS Computer Training Corp.
jstucklex@attglobal.net
==================

[Back to original message]