Re: Additional new features

Subject: Re: Additional new features
From: "Gene Kim-Eng" <techwr -at- genek -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 6 Oct 2008 10:51:52 -0700

The only reason I can think of would be if that information
was readily available to users in some other form. If the
product is a high-level administration tool with a printed
manual that is in the hands of its only user, printed might
be preferable, especially if the user is likely to study the
printed manual before installing or using the tool. But if
the tool is some sort of multi-user system where users
log in remotely and may never see the actual printed
manual that is in the hands of the top-level administrator,
then where else are you going to put the information that
doesn't require someone who logs in and immediately
says "WTF is all this new stuff?" to go hunting for that
elusive book or signing up for bulletins or online KBs?

Gene Kim-Eng



----- Original Message -----
From: "Ronald Schwarz" <RSchwarz -at- cosmocom -dot- com>
> My Product manager wrote the official Documentation Plan for the new
> product release. He included What Additional Features are Available in
> one of the user documents. In my ten years of experience in other
> companies, this was put either in the Release Notes or the
> installation document.
>
> What are some good reasons for not putting such a section in a user
> document? The main output will be online help. The print version will
> be a secondary distribution. It seems this "what's new" section will
> hardly ever be read by someone using online help to solve a problem in
> the use of the product.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ComponentOne Doc-To-Help gives you everything you need to author and
publish quality Help, Web, and print content. Perfect for technical
authors, developers, and policy writers. Download a FREE trial.
http://www.componentone.com/DocToHelp/

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.


References:
Additional new features: From: Ronald Schwarz

Previous by Author: Re: Use of definite article
Next by Author: Re: Additional new features
Previous by Thread: Re: Additional new features
Next by Thread: Inserting Use Cases in Online Help


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


Sponsored Ads