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.
RE: Nested bullets - how many levels deep do you go?
Subject:RE: Nested bullets - how many levels deep do you go? From:"McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com> To:"Downing, David" <DavidDowning -at- users -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Fri, 13 Feb 2009 11:46:23 -0500
Downing, David wanted to know:
>
> 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?
I think I've encountered that once, ever. I just went with the three
levels of bullets (bit the bullet?). The alternative was a re-write of
the section, which put it out of sync with the levels of the surrounding
sections, which then needed to be re-written to accommodate, which then
put those sections out of sync with the surrounding chapters...
So I would have had to revise my entire book's heading structure (adding
a level, and then adding bumph paragraphs to many of those new headings
in order to avoid the also-forbidden situation of a heading following a
heading with no body text between. Way too much work for so little
gain, especially with a deadline.
Going to three levels of bullets, one time, was the lesser of evils. By
far.
You could try doing something with a table or tables, to get around the
technicality.
- Kevin
The information contained in this electronic mail transmission
may be privileged and confidential, and therefore, protected
from disclosure. If you have received this communication in
error, please notify us immediately by replying to this
message and deleting it from your computer without copying
or disclosing it.
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-