RE: (BOOKS FOR) Help on Procedure Writing

Subject: RE: (BOOKS FOR) Help on Procedure Writing
From: skwpt <skwpt -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 6 Dec 2001 05:29:09 -0800 (PST)

Anila:

This group has already sent you some excellent
feedback, especially about audience and testing.
Perhaps I can add a little value. I am in the process
of reading:

The User Manual Manual: How to Research, Write, Test,
Edit & Produce a Software Manual by Michael Bremer.
http://www.amazon.com/exec/obidos/ASIN/0966994914/104-1239505-2030359

I think it's "generic" enough to apply to most newbie
research. Here's the editorial review (of which, so
far, I agree): "...It describes the grammar, style,
techniques and tricks needed to write a manual the
gets read. It explains how to understand and target
readers. Plus, it covers special topics including:
dealing with rush projects, preparing for
internationalization, and handling projects with
multiple writers, multiple platforms and multiple
bosses...."

I also have in my "Save for later" cart at Amazon.com:

Establishing a System of Policies and Procedures
by Steve Page
http://www.amazon.com/exec/obidos/ASIN/1929065000/qid=1007644137/sr=1-1/ref=sr_1_79_1/104-1239505-2030359

I can't give yoy my personal opinion yet--in fact, I
don't know if I'll ever buy it--but it got very good
reviews, and it has been updated from the original
1984 edition to include quality management standards
compliance. Twenty-two reviewers gave it four and a
half stars.

Writing online help isn't quite so generic, as it
depends on the tool, but both HTML Help and RoboHelp
are extremely easy to learn/use. I have a book by
William Horton on "Designing and Writing Online
Documentation: Help Files to Hypertext" but I think
it's out of print.

...Oddly enough, a search on Amazon.com for "online
help" produced a lot of books on cyber-flirting,
choosing an online therapist, and breaking free of
compulsive online sexual behavior <vbg>.

HTH
Kelly

<AnilaA -at- ibsplc -dot- com> wrote:

I am new to the field of Tech Writing. I am in need of
information on the following topics:

Writing User Manuals
Writing Online Help


__________________________________________________
Do You Yahoo!?
Send your FREE holiday greetings online!
http://greetings.yahoo.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Collect Royalties, Not Rejection Letters! Tell us your rejection story when you
submit your manuscript to iUniverse Nov. 6 -Dec. 15 and get five free copies of
your book. What are you waiting for? http://www.iuniverse.com/media/techwr

Have you looked at the new content on TECHWR-L lately?
See http://www.raycomm.com/techwhirl/ and check it out.

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


Follow-Ups:

Previous by Author: Re: Why use screen shots at all? [WAS Survey: "Screen shots"]
Next by Author: RE: Voice Recorders and Voice recoginition software
Previous by Thread: RE: Network Security Article Clarification
Next by Thread: Re: (BOOKS FOR) Help on Procedure Writing


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


Sponsored Ads