RE: opinion on outline numbering for chapters/sections

Subject: RE: opinion on outline numbering for chapters/sections
From: "Lauren" <lauren -at- writeco -dot- net>
To: "'Gina Jones'" <gina -dot- techwriter -at- gmail -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 11 Jun 2008 12:13:18 -0700

I got confused with the roman letters. Legal, or "interleaved," numbering
is not confusing to me. But when I see " A)" followed by "
B)," I wonder what happened between the two steps because something is
missing. Also, using a closing parenthesis after a roman letter step number
in a legal list is confusing.

Why do you find legal numbering confusing? Is it new to you? What do the
asterisks represent? Have you taken a look at IEEE styles where legal
numbering is recommended?

IEEE also discusses how to handle numbered lists in the section above.

IEEE demonstrates by example how to use legal numbering in its style guide.


> From: Gina Jones

> Hey Everyone,
> I'm normally a lurker. I benefit from this list and thank all
> of you for
> your participation.
> I need some opinions on my numbering sequence in a User
> Guide. My client
> specifically requested that I embed the Quick Start into the
> manual and
> provide more details. I'm not a fan of outline numbering in
> user guides, but
> must follow their corporate style guide. Below is this
> particular numbering
> sequence.
> *
> 2.2*** Software Quick Start
> 2.2.1 Set Up Software Web Appliance
> A) Configure the Web Appliance
> <Step/Action table here>
> 1
> 2 a)
> b)
> c)
> d)
> e)
> f)
> B) Configure the Analyzers
> <Step/Action table here>
> 1
> 2
> C) Connect the Switch to the Analyzers
> <Step/Action table here>
> 1
> 2
> D) Connect the Ethernet.
> E) Access the Web Application.
> <Step/Action table here>
> 1
> 2
> 2.2.2 Set up Downstream Monitoring
> Once I get to I feel that the instructions become
> confusing, so I
> put A), B), C), etc. at the beginning of the headings since
> they are part of
> the sequence of steps. However, now I'm thinking that it makes it more
> confusing. What do you think?


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.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

opinion on outline numbering for chapters/sections: From: Gina Jones

Previous by Author: RE: Display, Displays, or Appears
Next by Author: RE: ANSWER to Links break in Word table
Previous by Thread: Re: opinion on outline numbering for chapters/sections
Next by Thread: Re: Tool to clean up MS Word (2003)

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

Sponsored Ads