TIP: Click on subject to list as thread! ANSI
echo: quik_bas
to: BUCKY CARR
from: PAT PRIDGEN
date: 1998-03-25 06:40:00
subject: Documenting Code

[In a message from Bucky Carr to Harry Hickey ]
 BC> I sure see what they mean.  I have a VB app that continues to grow,
 BC> then I stop for a few days and write some documentation, then go back
 BC> to coding, etc.  Trouble is, as the book says, *I*, as a programmer,
 BC> won't ever be able to do justice to the documentation...
I think the biggest problem with doing this is, after working on the
code for so long, that writing the documentation for it just tedious,
and not at the top of the list. Another problem is, what seems obvious
to you as the programmer is not obvious to the users at all. Want to
know what to put in the docs? Just give your program to someone who
isn't particularly computer literate. They'll find the holes, and ask
some of the darnedest questions.
.                         pat.pridgen@svis.org
.                          La Grande, Oregon
*SignIt 2.x #001* 
... Documentation - The worst part of programming.
___ Blue Wave/DOS v2.30
--- Maximus 2.02
---------------
* Origin: THE LOFT in Auburn IN 219-925-5524 & 238-3222 HST/V34+ (1:236/7)

SOURCE: echomail via exec-pc

Email questions or comments to sysop@ipingthereforeiam.com
All parts of this website painstakingly hand-crafted in the U.S.A.!
IPTIA BBS/MUD/Terminal/Game Server List, © 2025 IPTIA Consulting™.