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.
You're looking at the wrong end of the horse. (I realize you know this and are merely describing the situation that exists at your company, but the whole company is looking at the wrong end of the horse.) I've seen companies like this and the only answer is there is no solution unless they are willing to listen to reason and start looking at the right end of the horse.
Here's what is supposed to happen:
You have a project to complete (anything from a small ECO to a major new initiative--it doesn't matter). You generate a plan for that project. The plan includes all of the steps needed and lists all of the documents that must be produced. Each of those documents is of a type for which the company already has a centrally produced template.
The plan also shows dependencies between steps and dependencies to other projects (perhaps parent projects that are in process or already complete).
The individuals responsible for each of the documents are identified in the plan, and those individuals are responsible for ensuring that their documents are complete and up to date (with whatever formal or informal review process is called for in the plan).
The document templates might (optionally) have sections that explicitly require listing related documents that need to be reviewed when the present document changes, that list departments that need to be notified of changes, etc.
As you can see, this is exactly the opposite of what you have in place, so the cultural change required would be massive. However, if there is enough pain, and if you really are in touch with the right people, the change is manageable.
All of this can be managed quite effectively with the appropriate system. (Contact me off-list. That's the kind of software we make.)
Dick
John Posada <jposada01 -at- yahoo -dot- com> wrote:
>
>
>In my situation, each department handles documentation differently.
>Some, like my department, have a writer to write documentation.
>Unfortunately, this is a minority. In most departments, "someone" in
>the department writes anywhere from one to several documents. We may
>be talking about over 100 different document authors at one time or
>another.
>
>Everyone then submits their documentation to a centralized department
>who does some style/template enforcement, some monitoring to make
>sure that documentation that was dues for a project is submitted.
>Their main responsibility to roll out this documentation to the
>field. As soon as the document is delivered to the field, they wipe
>their job, respective of that document, is done.
>
>The problem arises when a change is made in one document, which is
>referenced by other documentation, referenced by other documentation.
[rest snipped for benefit of listbot]
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Free copy of ARTS PDF Tools when you register for the PDF
Conference by April 30. Leading-Edge Practices for Enterprise
& Government, June 3-5, Bethesda,MD. www.PDFConference.com
Are you using Doc-to-Help or ForeHelp? Switch to RoboHelp for Word for $249
or to RoboHelp Office for only $499. Get the PC Magazine five-star rated
Help authoring tool for less! Go to http://www.ehelp.com/techwr
---
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.