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.
Subject:Creating a Documentation Kit From:"Cara O Sullivan" <cara_osullivan -at- modusmedia -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Thu, 18 Oct 2001 10:36:09 -0600
Dear TechWhirl List:
Hi folks. I'd appreciate input on aan idea I have for a rather complex
documentation situation. I work for a global fulfillment and shipping
company that has over 20 plants around the world, and about 3,200
employees.We have a few hundred IT employees involved in Help Desk, front-
and back-office IT systems management and even software development.
I am the only documentation writer in all of this. As you can imagine, our
process and IT documentation requirements are enormous. And you also know
that documentation can help enforce IT standards. Well, we've got a huge IT
implementation project at the moment that involves lots of testing and
documenting.
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.
Has anyone on this list ever done anything similar to this? If so, what
pitfalls should I avoid? And is there anything else I could include in the
kit to make it more effective? This kit will be used by people who know lots
about their jobs--some will be good writers and most probably won't be. They
will also be people who don't want to be writing. I've tried to design this
kit with that in mind. This kit really takes the place of a global team of
writers, which is what we should have but simply can't afford in the current
economic environment.
Thanks in advance for any advice you may have.
Cara O'Sullivan, Provo, Utah
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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.