Re: The user guide prescribes the program

Subject: Re: The user guide prescribes the program
From: Peter Gold <pgold -at- NETCOM -dot- COM>
Date: Mon, 6 Jan 1997 12:21:58 -0800

I can't quote "accepted standards" for this, but just think about it from
a slight distance:

Docs are the project blueprints. If all the people leave the project, and
the prototypes are lost, and the factory is lost, but the excellent docs
survuve, the project can be recreated more-or-less straightforwardly from
the blueprints. Without them, good luck!, no matter how many of the other
components remain.

Peter Gold

On Mon, 6 Jan 1997, joe rapp wrote: [snipped]

> This engineer told me it is standard thinking that the
> computer program IS the user guide, while the code is just
> the code. If the program "doesn't work" properly, then
> changes are made to the code -- not vice versa.

TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
Search the archives at or search and
browse the archives at

Previous by Author: Re: Documentation Group needs advice!
Next by Author: Re: Mythical Frame learning curve
Previous by Thread: The user guide prescribes the program
Next by Thread: Re: The user guide prescribes the program

What this post helpful? Share it with friends and colleagues:

Sponsored Ads

Sponsored Ads