section numbering

Subject: section numbering
From: Matt Ceglia <mceglia -at- WHISTLE -dot- COM>
Date: Fri, 14 Mar 1997 10:22:43 -0800

I've been assigned to redesign our existing documention, and our
contract writer (who will be doing most of the rewriting) has strongly
suggested that we use a section-numbering scheme to facilitate
cross-referencing. The manual is a 150-page reference guide for a
networking hardware/software product. It is targeted to a fairly
nontechnical audience.

Although I'm not necessarily opposed to section numbering, I don't see a
lot of it anymore. Are there any guidelines for determining whether
these numbers are worthwile? Does anyone have strong opinions for or
against section numbering?

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: Looking for Madison, WI job info
Next by Author: Re: Assumptions about abbreviations
Previous by Thread: Brochure design
Next by Thread: Re: section numbering


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


Sponsored Ads