RE: Nested bullets - how many levels deep do you go?

Subject: RE: Nested bullets - how many levels deep do you go?
From: "Michael West" <mbwest -at- bigpond -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Sun, 15 Feb 2009 22:04:48 +1100

> From: "Downing, David" <DavidDowning -at- users -dot- com>
> We routinely use second-level nested bullets in our documentation, but
> our policy is to never take it beyond a second level. However, there
> have been times when I saw a need to go to a third level. (I just ran
> into one.) I've been told that when that happens, I need to figure out
> some way of leveling out the hierarchy so I can keep the list to two
> nesting levels. (I think one of my editors once suggested that if I felt
> the need to go to a third level or beyond, I was overthinking.) So I was
> wondering what other folk here do. Do you ever go beyond a second level,
> or do you avoid any nesting at all?
>
[MW>]

It's well nigh impossible to give an intelligent answer to that question
without knowing what the list is intended to accomplish. What is it a list
OF?

My first instinct is to suggest that anything that requires three levels is
too complex to be a "list". An exception might be mage if the list is
actually not a list but a sort of introductory structured outline of some
subject matter that you are preparing to cover in more detail.

If you really intend this thing to be a "list", then putting it in a
multi-level structure is too much like asking your readers to do your work
for you. It's actually several lists that you are trying to bundle into one.
That's asking a lot of your readers.

Your job as a writer is to communicate this "list" (or these lists) in
easily assimilated terms. It doesn't sound like that's what's happening.

I hope I'm wrong.

--
Mike West

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals.
http://www.doctohelp.com

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/

---
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 http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


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
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


Previous by Author: Re:Highlighting new material in Webhelp - temporarily
Next by Author: When the term "Technical Writer" just doesn't cut it
Previous by Thread: RE: Nested bullets - how many levels deep do you go?
Next by Thread: "advance" vs "advanced"


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


Sponsored Ads