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.
Subject:Re: Document Numbering From:Dave McGill <MCGILL -at- ASET -dot- SENECAC -dot- ON -dot- CA> Date:Wed, 12 Jul 1995 09:40:43 EST5EDT
Rikki Nyman asks:
> Does anyone out there have any strong opinions about document
Dan Azlin has already made some excellent comments, regarding audience
analysis and document design, to consider when trying to aid your
reader in navigating your document.
There are occasions when you have to use a numbering hierarchy (e.g.
when responding to a spec which uses such a system). My view is that
there is a tendency for people to overdue numbering systems. (I
see alot of work from students who, when first exposed to the concept,
number almost every paragraph.) Good design, of heads and sub-heads
etc., should make the relative importance of different parts of a
document obvious. My inclination is to use no more than 2 levels of
numbering at most.