Re: text production process

Subject: Re: text production process
From: Jan Henning <henning -at- r-l -dot- de>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Sun, 26 Jan 2003 14:32:31 +0100


"Processes convert inputs into outputs." But our inputs enter the process ad hoc -- at any point, at any time. The output isn't quality controlled.

You don't have a process then. And, despite "process" being used as a buzzword, it is a very useful tool when you have to create complex documentation (or create documentation in a complex environment).

Some things to consider:

- Make sure the process is acceptable to all significant participants. And that includes, in your case, the other departments, especially those that provide input.

- Make sure that everybody understands and accepts where and how they need to modify the way they work. (And, yes, if you do not have a process now, it is very likely that they will need to do so.)

- Make sure that the process is flexible enough to accommodate real-world deviations. In other words, anything that could reasonably happen should be able to be fitted into the process.

- Make sure that the process is rigorous enough that you have a decent chance of catching problems while they are still manageable. I.e., do not make the process so flexible that just about any kind of behavior could still be interpreted as being within the guidelines of the process.

- Be sure to point out when there is a significant deviation from the process and spell out the consequences. (E.g., "The software has been completely redesigned one week before release, despite assurances that it was feature-complete. This means that we will be able to either deliver the documentation in the promised quality three weeks late or on time but with a great likelihood of factual errors and omissions.") The point is not to assign blame but to give the customer (in this case the other department) a choice of consequences. Having an agreed process means in this case that you can defend yourself against being blamed for something that isn't you fault.

Regards
Jan Henning

--------------------------------------------------------------------
Jan Henning
ROSEMANN & LAURIDSEN GMBH
Am Schlossberg 14, D-82547 Eurasburg, Germany

Phone: +49 700 0200 0700, Fax: +49 8179 9307-12
E-Mail: henning -at- r-l -dot- de, Web: www.r-l.de
--------------------------------------------------------------------


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
A new book on Single Sourcing has been released by William Andrew
Publishing: _Single Sourcing: Building Modular Documentation_
is now available at: http://www.williamandrew.com/titles/1491.html.

Help Authoring Seminar 2003, coming soon to a city near you! Attend this
educational and affordable one-day seminar covering existing and emerging
trends in Help authoring technology. See http://www.ehelp.com/techwr-l2.

---
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:
Re: text production process: From: John Garside

Previous by Author: Re: text production process
Next by Author: Re: Screen-text sample-code
Previous by Thread: Re: text production process
Next by Thread: Re: text production process


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


Sponsored Ads