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.
Subject:Documentation and CMM? From:Maaike Groenewege <mgr -at- MEDIASYS -dot- NL> Date:Fri, 19 Feb 1999 09:46:09 +0100
Judging from your posts to this list, I should consider myself one of the
more lucky techwriters around: I have a real office with real windows, doors
and a real fellow tech writer, two computers (one for writing my docs, and
one to access the software application I'm documenting), I am invited to
take part in relevant meetings, and, overall, documentation is taken very
seriously. (In case of job openings, I'll make sure to post them to you
Recently, my company has started implementing the Capability Maturity Model
in its organisation. This basically means that no action that is taken
should go unaccounted, unplanned or unexplained. The ultimate goal of the
model is to reach a professional organisation which uses mature processes.
The web abounds with information about CMM, so I won't say too much about
its details here.
My manager has suggested that documentation somehow should be fit into this
model too, so that the well known "It's three weeks before the final release
date, and oh yeah, we should have some documentation" issue can be avoided.
Although many people within the company have already advised me on how to do
this, I'd like to hear your opinions too.
Does anybody here have any experience with setting up formal documentation
procedures? Do you have any suggestions on where to start? What difficulties
have you encountered? What benefits did it bring? Did you have trouble
convincing other people in your company about the benefits?
Mediasystemen b.v., a Triple P company