RE: doc release numbering

Subject: RE: doc release numbering
From: obair81 -at- comcast -dot- net
To: "Joe Malin" <jmalin -at- tuvox -dot- com>
Date: Wed, 03 May 2006 17:16:50 +0000

Be prepared to be stunned. The BOM does not contain a part number for the doc. Maybe I should insist on this from now on.

I like your part number/rev number combo. Where do you put this?


-------------- Original message ----------------------
From: "Joe Malin" <jmalin -at- tuvox -dot- com>
> Hi!
> What I do is assign a product/part number to the document, and also a
> revision number.
> for example DD12345-01 is the initial release and DD12345-02 is the next
> revision *of the document*.
> The part number for a document does *not* have to match the part number
> for the product it documents.
> *Most importantly*, the *revision numbers* do not have to match. A
> customer determines the document for a particular product from
> information in the document itself. Your company matches the document to
> a product revision through the product's bill of materials (BOM).
> Particularly for hardware, a BOM and a kitting/pick list are
> indispensable. Paul, I'd be stunned if your company did not have a BOM
> for the product that included the manual complete with its part number.
> My standards are based on many years' work in both the hardware and
> software sides of the computer business, in which I've done as much
> management/release work as anything else. I find that knowing "how the
> sausage is made" helps in integrating my documents into the company's
> overall process. In my new startup company, I'm finding I have to make
> up the process as I go!
> Joe
> Joe Malin
> Technical Writer
> (408)625-1623
> jmalin -at- tuvox -dot- com
> The views expressed in this document are those of the sender, and do not
> necessarily reflect those of TuVox, Inc.
> -----Original Message-----
> From: techwr-l-bounces+jmalin=tuvox -dot- com -at- lists -dot- techwr-l -dot- com
> [mailto:techwr-l-bounces+jmalin=tuvox -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf
> Of obair81 -at- comcast -dot- net
> Sent: Wednesday, May 03, 2006 9:40 AM
> To: techwr-l -at- lists -dot- techwr-l -dot- com
> Subject: doc release numbering
> Due to things beyond my control, we (I) had to turn out a doc set last
> week for a new hardware product, and next I will have to turn out
> another (updated) doc set for the same product. The product name/number
> have not changed.
> Is there any sort of standard for numbering versions of the docs, if the
> product is not changing?
> I have not dealt with this question before.
> The voice(s) of experience would be welcome.
> Thanks.
> best,
> Paul


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!.

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo 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.

Previous by Author: Re: doc release numbering
Next by Author: RE: graphics
Previous by Thread: RE: doc release numbering
Next by Thread: RE: doc release numbering

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

Sponsored Ads