TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Cara asked about an IT development kit described what she has proposed:
To meet the need, I've proposed the idea of a documentation kit that
contains a MS Word template (this is an internal standards); a how-to guide;
and a pre-formatted Excel project spreadsheet that will help team leads
plan and track the progress of their documentation. I'll be available to
help plan the projects, review drafts and provide editing support. The
managers involved with this project are very enthusiastic about the kit and
getting their people trained on it.
This sounds like a great kit, Cara. I can't imagine your job--sounds like a
challenge! However, you seem to have put together some good plans on how to
undertake this documentation project.
The one thing that came to my mind when reading this was your MS Word
template. I understand that it is a company standard, but in my experience,
people who aren't familiar with Word don't like to use it, make mistakes
when using it, and kind of make a mess. To us, it's a natural tool, but not
to everyone else.
Any chance you can have a web-based data entry form that replicates the Word
template in structure? People wouldn't have to deal with styles or
formatting, but could just type data in at prompts to complete forms. These
forms could be saved to a database or XML files, then you could use them to
create your docs.
No, I haven't done this, though I've read about others on the forum who
have. It just seems like by restricting what people can and can't do (in a
good way) and by not giving them a "blank page" as Susan Gallagher describes
it, you might help them out a lot in terms of their cooperation and comfort,
and help yourself avoid stripping out "formatting" that good-intentioned
people added to the Word files.
Just my $0.02. I'm sure other folks will have some good recommendations.
FarPoint Technologies, Inc.
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.