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.
> What are your thoughts on document numbering? Important? Not so
> important? What's the value of it?
>From the user's standpoint, document numbering has little value or
utility over a conventional document title combined with a version
number or publication date.
Document numbering is primarily of value to your company's internal
processes, incluidng development, production, product release,
publishing (e.g. to a website) and archiving. How much value they
add depends on the size of your company and the maturity/complexity
of the company's processes. If you are part of a small company,
are the only writre, and support only a few products, document
numbers may not offer much advantage. But if you are part of a
pubs department that has to feed deliverables into a manufacturing
process (or even if you have to hand off your documents to another
group for publication to your company's website), document numbers
are extrememly valuable for uniquely identifying a specific version
of a specific information product without relying on anyone's parsing
and interpreting the significance of a multi-word title. The number
need not have any semantic significance (in fact, it is often *very*
difficult to develop an information taxonomy that will remain valid as
a company and its information products evolve), since it's primary
purpose is to provide unambiguoius identification that the information
product matches the BOM or the publication order or the DVD build
specification.
Just my $.02, but based on 15 years of using doc ID numbers versus
10 years of not using them.
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-
