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:Pros or Cons of Section Numbering From:DAVID IBBETSON <ibbetson -at- IDIRECT -dot- COM> Date:Sat, 31 Aug 1996 18:14:51 -0400
I first met this sort of section numbering at school in a maths text book
written by one of our masters.
I like it. I also like it in Classical works, including the Bible, where the
section numbering is a reference that works for all editions and
translations. Similarly I like line numbering in long poems.
A users' manual is a technical document. To my mind section numbers are
appropriate in technical writing. Against this I have seen claims that some
readers are put off by section numbers and footnotes. I don't understand
why*, and suspect that such people are likely to prefer "Dummy's Guides to
Lovemaking" or whatever.
As always the question isn't the writer's preference but what the audience
will find most helpful.
* I also suspect that some of these allegations
come from people whose tools can't handle
section numbers and footnotes. I have seen
a recent string on section numbering in Word
and I want footnotes in PageMaker.
If the trumpet give an uncertain sound, who shall prepare himself to the
battle? -- I Corinthians xiv, 8
TECHWR-L List Information
To send a message about technical communication to 2500+ list readers,
E-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send administrative commands
ALL other questions or problems concerning the list
should go to the listowner, Eric Ray, at ejray -at- ionet -dot- net -dot-