[oclug] documentation rant

Michael P. Soulier msoulier at storm.ca
Thu Apr 26 20:30:04 EDT 2001


On Thu, Apr 26, 2001 at 05:56:07PM -0400, Gilles J. Seguin wrote:
> 
> You have to place you now in the developper perpective.
> 
> If you are tire of reading howto, do this.
> 
> choose a pakage
> dowload source
> for i in *.c *.h do
> 	wc -l $i
> done
> now add them up and divide by 60(nbr of lines by page)
> time is a scare resource.

    Oh, of course. I'll just read the source! A well-written document
concealing the implementation for those of us who don't care couldn't possibly
help in using it. *sigh*

    BTW, I'm referring to user's guides here. 

    Oh, and don't assume I'm not a developer. I code all day, and my projects
are well-documented. Sorry, but it's not that hard to keep information
accurate. I'm tired of the cop-outs. 

    Mike

-- 
Michael P. Soulier <msoulier at storm.ca> 
"With sufficient thrust, pigs fly just fine. However, this is not necessarily a
good idea. It is hard to be sure where they are going to land, and it could be
dangerous sitting under them as they fly overhead." -- RFC 1925
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 232 bytes
Desc: not available
Url : http://tux.oclug.on.ca/pipermail/oclug/attachments/20010426/d219cb27/attachment.bin


More information about the OCLUG mailing list