Re: Desiging your Documentation/Writing Department

Subject: Re: Desiging your Documentation/Writing Department
From: "Fred Ridder" <docudoc -at- hotmail -dot- com>
To: techcommdood -at- gmail -dot- com, techwr-l -at- lists -dot- techwr-l -dot- com
Date: Wed, 09 Aug 2006 10:08:50 -0400

The one thing I'd add to this wish list assumes that there is a
CMS in use and that there is some degree of reuse, single-
sourcing, and/or collaborative authoring. The one additional
role I'd add is that of a librarian/taxonomist. This person
wouldn't necessarily be responsible for generating or editing
content, but would be completely responsible for ensuring
that all information objects are appropriately identified (titled)
and that the CMS has all the appropriate metadata on each
information object. Even in our own little pubs group (8 writers)
and with the limited amount of reuse and shared content we
have tried to achieve, the biggest obstacle has been that
nobody knows what potentially useful information objects
have been created by other writers for other projects/products.
What an amazing concept it would be to have one person you
could ask who was likely to know whether the object you
need already exists and tell you exactly how to query the
repository to find it.

My opinions only; I don't speak for Intel.
Fred Ridder
Parsippany, NJ

From: "Bill Swallow" <techcommdood -at- gmail -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: Desiging your Documentation/Writing Department
Date: Wed, 9 Aug 2006 09:13:09 -0400

My ideal would be to have a staff consisting of technical writers,
editors, technical illustrators, developers, publishers, and IT

Writers - focus on developing content.
Editors - focus on detailed editing of what writers produce
Illustrators - focus on providing clean, consistent, accurate
illustrations in support of content development
Developers - focus on building sample applications, integrating Help,
and maintaining code-side documentation
Publishers - focus on producing all deliverables for all writing projects
IT - DBA or like role supporting a CMS

This is an ideal, but will likely not be a reality outside of very large shops.

Bill Swallow
HATT List Owner
WWP-Users List Owner
Senior Member STC, TechValley Chapter
avid homebrewer and proud beer snob
"I see your OOO message and raise you a clue."

Don?t just search. Find. Check out the new MSN Search!


WebWorks ePublisher Pro for Word features support for every major Help format plus PDF, HTML and more. Flexible, precise, and efficient content delivery. Try it today!

Easily create HTML or Microsoft Word content and convert to any popular Help file format or printed documentation. Learn more at

You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-
To unsubscribe send a blank email to techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

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

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit for more resources and info.


Re: Desiging your Documentation/Writing Department: From: Bill Swallow

Previous by Author: RE: Page Margins in Word
Next by Author: RE: Breaking into the tech writing job market
Previous by Thread: Re: Desiging your Documentation/Writing Department
Next by Thread: Re: Desiging your Documentation/Writing Department

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

Sponsored Ads