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:Nested bullets - how many levels deep do you go? From:Geoff Hart <ghart -at- videotron -dot- ca> To:TECHWR-L Writing <techwr-l -at- lists -dot- techwr-l -dot- com>, David Downing <DavidDowning -at- users -dot- com> Date:Fri, 13 Feb 2009 14:02:37 -0500
David Downing wondered: <<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'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.)>>
I have a lot of sympathy for your editor's attitude. If you include
numbered steps as level one of the "bullets", and true bullets as
level 2, that's about as far as I'm comfortable going. Dive any deeper
than that and you'll be moving beyond the point at which the hierarchy
is easily comprehensible.
Possibly you should send us an example of your problem and see if we
can come up with a better solution? For example, those few times I've
been tempted to go to three levels of bullets, I found that replacing
the 2nd and 3rd levels with a two column table solved the problem
neatly. In many cases, the 3rd level turned out to be options that
described the 2nd level rather than something that truly required a
3rd level.
--------------------------------------------------------
Geoff Hart (www.geoff-hart.com)
ghart -at- videotron -dot- ca / geoffhart -at- mac -dot- com
--------------------------------------------------------
***Now available*** _Effective onscreen editing_
(http://www.geoff-hart.com/books/eoe/onscreen-book.htm)
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-