Re: Unique doc IDs

Subject: Re: Unique doc IDs
From: <neilson -at- windstream -dot- net>
To: "Sarah Bouchier" <Sarah -dot- Bouchier -at- exony -dot- com>,<techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 6 Aug 2007 12:55:19 -0400

Here are some thoughts on numbering of documents:

1. Limited schemes fail. When they fail they need
expansion or replacement. For instance, a set
of numbers such as BOOK-nnn can handle up to
1000 books, and cannot easily accept non-book
media or collections of books.

2. Complicated, limited schemes fail worse.
Numbers can easily encode a small amount of
information to distinguish various kinds of
media, fields of knowledge, or print formats.
For example, SM-nnnnn might be the software
manuals, and HM-nnnnn the hardware manuals.
Attempting to encode too much into a part
number can cause difficulties. Simpler schemes
are generally better than complicated ones.

3. Numbers can be self-verifying. See the
Wikipedia entry for check digits.

4. Numbers within an organization should be
generated by a single authority. Whether this
authority also maintains the list of the
meanings for each of the numbers is not
really important, but it should record to
whom, when, and for what purpose each number
was supplied.

5. Even if letter prefixes are used, it is wise
to avoid re-use of digit patterns. For instance,
BK-2345 and CD-2345 should not both be allowed.
It is an especially bad idea to attempt to
maintain parallel part numbers for items that
are supposed to be somehow related. Maintaining
parallel lists can soak up a lot of time and
effort.

6. If numbers with "meaning" are desired, it is a
good idea to have a pair of numbers for each
item, divorcing the unique and technical part
number from the "meaning" number. For example,
item W2388-7559-264 in the master list can be
publication JB-240. This way the second edition
of JB-240 can be item number W2388-7587-342 and
whether to market it as JB-240, JB-241, JB-240-2,
JB240(bis), or JB-240a is not an issue for the
Number Police.




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


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

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.


Previous by Author: Re: How to...
Next by Author: Re: _For Dummies_ books?
Previous by Thread: RE: Unique doc IDs
Next by Thread: Re: Unique doc IDs


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


Sponsored Ads