Re: Doc Design and Convention ( was TECHWR-L Digest, Vol 48, Issue 27)

["Gene Kim-Eng" <techwr -at- genek -dot- com>]

If a company provides me with a document set as part of its presale 
presentation, one of the things i look for is an indication that they know where 
to put different kinds of information.  User manuals that read like advertising 
brochures for a company's other products - or worse, like advertising brochures 
for the very product the reader has (presumably) already purchased - do not tend 
to make me want to buy a company's products.  They just irritate me.

Gene Kim-Eng


----- Original Message ----- 
From: "Robert Lauriston" <robert -at- lauriston -dot- com>
> By focusing narrowly on technical concerns you're excluding the
> specific business contexts in which the tool will be used and thus
> perhaps industry-specific warnings and tips that could be helpful to
> users.
>
> Whether that matters probably depends on how varied the product's uses
> are in practice.
>
> Also, a good technical writer should think like a marketer to the
> extent that the docs may be used as presales tools.

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

Are you looking for one documentation tool that does it all? Author, 
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at:
http://www.doctohelp.com/ 

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! 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. 

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat