Re: Creating a Documentation Kit

Subject: Re: Creating a Documentation Kit
From: Steven Brown <stevenabrown -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 18 Oct 2001 11:53:27 -0700 (PDT)

Hi Cara,

I have a few thoughts for you, specifically about Word
templates.

Maybe I'm underestimating the business world in
general, but I'd venture a guess that 95 percent of
the people who use Word don't know anything about
using or applying templates. We tech writers know all
too well how fickle Word can be, and when you toss in
a template, things can get really troublesome. Because
Word is the most prevalent word processing
application, I understand that you must use it. But as
you proceed, try to reduce the room for error as much
as possible.

So, the first thing I'd do is verify that every style
in the template has the "Automatically Update" option
deselected. Doing so ensures that when someone changes
the formatting for a particular paragraph, the
underlying style (and all of the paragraphs already
formatted with that style) will remain unchanged.

Because most of the contributors are not writers, I'd
suggest providing as much structure for them as
possible. Maybe the template contains a series of
tables, and the contributors enter information only in
designated cells. Or maybe you can create "forms" (or
whatever they're called in Word), in which you
write-protect all areas except those fields in which
the contributor enters text.

Hope that helps. Sounds like you've got your work cut
out for you.

Steven Brown
Senior Technical Writer


__________________________________________________
Do You Yahoo!?
Make a great connection at Yahoo! Personals.
http://personals.yahoo.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Announcing new options for IPCC 01, October 24-27 in Santa Fe,
New Mexico: attend the entire event or select a single day.
For details and online registration, visit http://ieeepcs.org/2001

Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.

---
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.


References:
Creating a Documentation Kit: From: Cara O Sullivan

Previous by Author: Re: System Architecture / Documentation
Next by Author: Re: White Papers
Previous by Thread: RE: Creating a Documentation Kit
Next by Thread: RE: Creating a Documentation Kit


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


Sponsored Ads