Document Numbering

Subject: Document Numbering
From: Daniel P Read <danielread -at- JUNO -dot- COM>
Date: Wed, 23 Apr 1997 23:34:02 EDT

Hello,

Has anyone had experiences good or bad with the numbering of documents on
a large project? There is talk going around above me that we are going
to come up with a numbering scheme for the project's myriad documents. I
presume that this will include using the document numbers in 8.3
filenames. At first blush, I don't like this idea.

For one, I don't try to pressure developers and other authors to keep
track of minor issues such formatting and revision numbers. Besides the
fact that most probably would not keep up with such things if I did
insist on it, it is my opinion that they should not have to. I can
reformat a fifty page document from top to bottom in well under half an
hour, and people who don't live in Word like I do would lose valuable
time away from writing code messing with document formatting. By the
same logic, I don't help them write their code. I can't imagine asking
them to learn a non-intuitive, non-mnemonic numbering scheme for naming
and finding documents. They'd have to cross-reference some list just to
look up the latest database definitions. I do agree that standardization
is positive, when used appropriately, but I think that a simple,
English-based naming system, in combination with simple version
numbering, would be much better. xxxxDSGN.DOC for specs, xxxxUTP.DOC for
unit test plans, xxxxOM.VSD for object models--that sort of thing.

Am I missing something here? Inisight is appreciated.

Take care,
Daniel Read

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
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html


Previous by Author: Re: keyboards
Next by Author: Travel Plans
Previous by Thread: [no subject]
Next by Thread: Re: Document Numbering


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

Sponsored Ads


Sponsored Ads