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.
I'm working with a client on preparing an outline for
their documentation process. The company is
(relatively) small, but growing fast, and wishes
to put in place a process which will be equally
effective no matter what size the doc. group ends
up at. Currently three to four tech. communicators.
The client and I cannot agree on what is the standard
process for editing. I suspect that there isn't one :-)
which is why I'm soliciting your help.
The subject matter is fairly modular, making it
feasible for multiple writers to work on the same
products' documentation. There is a style guide,
(although much in need of updating), a glossary
system, a separate indexer, and much legacy material.
The client contends that it is standard practise for
writers to submit first drafts of all material to editors
for review, a chapter at a time. That the editor then
marks up the changes, and returns the whole to
the writer, who implements the changes across
all the material after finishing the first drafts of all
the chapters he/she is responsible for.
I think that this is a most inefficient way of using
resources, and would prefer to see a process
whereby a sample/first chapter is submitted to
the editor for review, this is marked up by the editor
and changes discussed with the writer, who then has
the opportunity to write according to correct guidelines
from the (almost) start if they have not done so already.
With a coherent style guide, this should be possible.
The editor can then concentrate on clarity, grammar,
consistency, punctuation, completeness - etc. and
not necessarily in that order.
Has the client been reading too much Dilbert? Or
am being overly optimistic? Opinions and experiences