Re: Document Creation/Change

Subject: Re: Document Creation/Change
From: "Gene Kim-Eng" <techwr -at- genek -dot- com>
To: <vrfour -at- verizon -dot- net>, "'Techwr-L List'" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 11 Jul 2007 07:40:35 -0700

----- Original Message -----
From: "James Barrow" <vrfour -at- verizon -dot- net>

> They were
> trying to manage projects vicariously through the tech writers.

Been there, done that. At a previous employer the development
process was chaotic, and the developers shined on all attempts
to document process because they didn't want to have to be
held accountable for not following a process. The job of
documenting process was dumped on Tech Pubs, and we
were told if the developers wouldn't cooperate to document
how the QA manager *thought* things ought to be done. Of
course, nobody followed this, and my senior staff and I saw the
approaching "inaccurate process documentation scapegoat train"
coming a mile away. We are all no longer with that company as
it sets slowly into the west.

> It's a little bit of both. The entire project is out of control

Anytime somebody, anybody, attempts to rein in an out of
control process, there will inevitably be a power struggle,
between one party wanting to be in control and everyone
else wanting to continue the nobody-in-control status quo.
If the struggle is between two parties wanting to be the one
in control, though, it's an indication that the lack of control
extends to a level above both.

> I think I resolved the situations by putting the proposed solution into
> effect.

The best way to throw light on a bad process is often to follow
it to the letter. assuming you can do that without producing an
unrecoverable disaster.

> So the project managers staged a coup and convinced the PMO that my solution
> was better. Ha ha...ha ha.

The meeting control part was always wacky. But one part of
the proposed solution, having a point at which ownership of
document content passes into the hands of some higher authority
that must bless further changes in advance, is really a good thing
in an out-of-control development process. Your proposed
solution appears not to have anything that verifies that all those
"documents" the Sharepoint users upload into the system for you
to work on should exist at all. Unless there was some step in
the process I missed...?

Gene Kim-Eng

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.


Follow-Ups:

References:
RE: Document Creation/Change: From: James Barrow

Previous by Author: Re: Document Creation/Change
Next by Author: Re: Client misunderstanding of public domain
Previous by Thread: RE: Document Creation/Change
Next by Thread: Document Naming Convention


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


Sponsored Ads