Re: User Manual par excellance

Subject: Re: User Manual par excellance
From: "Mike O." <obie1121 -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 20 Sep 2005 08:51:05 -0700 (PDT)


Peggy Lucero wrote:
> OK, I've gotten feedback from boss about the User Manual.
> Complaint is first 5-7 pages just don't grab and pull the
> reader in. I've been told that it needs more purpose and
> focus.

So just delete the first 5-7 pages and cut straight to the part with
purpose and focus. I'm totally serious. Most tech doc introductions are
completely dispensable, regardless of the skill or sincerity of the
writer. If you want something to grab and pull the reader in, write a
killer brochure.

Mike O.




______________________________________________________
Yahoo! for Good
Donate to the Hurricane Katrina relief effort.
http://store.yahoo.com/redcross-donate3/


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

Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l

Doc-To-Help 2005 converts RoboHelp files with one click. Author with Word or any HTML editor. Visit our site to see a conversion demo movie and learn more. http://www.componentone.com/TECHWRL/DocToHelp2005

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.



Follow-Ups:

Previous by Author: salary for entry level position ...
Next by Author: Linux for tech pubs
Previous by Thread: Re: User Manual par excellance
Next by Thread: Re: User Manual par excellance


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


Sponsored Ads