Revision Numbers

Subject: Revision Numbers
From: Rebecca Phillips <Rebecca -at- QRONUS -dot- CO -dot- IL>
Date: Thu, 23 Jan 1997 16:29:38 +0200


A new manager has been implanted at our company (a welcome change). Her
experience has been in a highly-structured organization that dealt with
military computer systems, and they were hot on using a lot of strict
specifications. However, I am hesitant about two of the suggestions she
has made for the documentation, and I would like to bounce them off of
you guys (she thought that was a great idea, too.) I wrote two separate
mails since they are two separate questions.

Part 1.
When I integrate new version changes into the manual, she would like to
include change bars (revision marker in the margin) to show where the
change has taken place in the manual. Next to the change bar, the
software version number would appear, so that you would have an exact
record of when the change was implemented. I don't mean she wants these
changes for SME reviews. She wants the CUSTOMER to get the final draft
of the manual WITH CHANGE BARS so that the customer can see the new

I am not concerned about technical issues of "how to" implement. I want
to get feedback on "whether to implement". I am concerned that this
change will interfere with the manuals' readability. She believes that
these changes are more conventional and that they will help us (one day)
get ISO9000 certification. She says that this is great for an existing
customer who doesn't want to read through the whole manual again (as if
he'd read it the first time) to find out what has changed.

Has anybody released books with change bars? How did customers react? Is
this, in fact, a requirement for ISO9000? Do you feel that same gut
feeling as I, that this isn't going to be useful in the long run?


Rebecca M. Phillips
Documentation Manager
Qronus Interactive Ltd.
Automated System Testing
rebecca -at- qronus -dot- co -dot- il

TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
Search the archives at or search and
browse the archives at

Previous by Author: Version Release Notes
Next by Author: Re: Tops in the Field
Previous by Thread: Re: Version Release Notes
Next by Thread: Re: Revision Numbers

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

Sponsored Ads

Sponsored Ads