Re: Numbering in Docs

Subject: Re: Numbering in Docs
From: "Robert Plamondon" <robert -at- plamondon -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 9 May 2003 12:18:42 -0700

My preference is to declare at the outset that our document are books, and
that books should be formatted according to the CHICAGO MANUAL OF STYLE.
This turns most questions into something you can look up rather than
something everyone can argue endlessly about. The ability to refer to a
standard text saves a great deal of time and annoyance, and is worthwhile
for this reason alone.

The setup you described is idiosyncratic. Chapter-based page number is, to
my taste, annoying, but it's standard enough that it will pass without
comment. The appendix system you describe is laughable and will be
considered amateurish by your readers.

-- Robert
Robert Plamondon
President, High-Tech Technical Writing
robert -at- plamondon -dot- com
"We're Looking for a Few Good Clients"


Order RoboHelp X3 in May and receive a $100 mail-in rebate, PLUS
free RoboScreenCapture and WebHelp Merge Module.

Order RoboHelp today:

ATTENTION FrameMaker Users: Fill-out the following survey
to receive a chance to win a FREE RoboScreenCapture.

FM users only please:

You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

Previous by Author: Re: Match the Views?
Next by Author: RE: numbering in docs
Previous by Thread: RE: numbering in docs
Next by Thread: RE: Numbering in Docs

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

Sponsored Ads