doc to help theory

Subject: doc to help theory
From: Alexander Von_obert <avobert -at- TWH -dot- MSN -dot- SUB -dot- ORG>
Date: Wed, 12 Jun 1996 17:02:00 +0100

Hello Angela,

* Antwort auf eine Nachricht von Angela an All am 30.05.96

A> From: Angela <amoore -at- softdesk -dot- com>

A> We're working on a manual that we plan to convert to help very
A> shortly

A> Because of the nature of the beast, the manual and help are two
A> very different things and need to be maintained separately.

I prefer to generate them separately - different contents, different writing
styles...

You should decide first on where to put what. Background info should be in the
manual, but all the important details like data formats could be in the online
documentation only. You could even try to exclude from the manual many of
those details that change from version to version or even from bugfix to
bugfix. This way you could use one batch manuals for a longer period of time.


Greetings from Germany,
Alexander

--
|Fidonet: Alexander Von_obert 2:2490/1719
|Internet: avobert -at- twh -dot- msn -dot- sub -dot- org

| Standard disclaimer: The views of this user are strictly his own.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Post Message: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
Get Commands: LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU with "help" in body.
Unsubscribe: LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU with "signoff TECHWR-L"
Listowner: ejray -at- ionet -dot- net


Previous by Author: Rules of Thumb for Estimating/Budgeting Online Documentation
Next by Author: doc to help theory
Previous by Thread: Re: doc to help theory
Next by Thread: doc to help theory


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

Sponsored Ads


Sponsored Ads