Re: How many levels of indents and heads are reasonable?

Subject: Re: How many levels of indents and heads are reasonable?
From: "Raj Machhan" <raj -dot- machhan -at- gmail -dot- com>
To: "Ned Bedinger" <doc -at- edwordsmith -dot- com>
Date: Sun, 14 Oct 2007 02:41:57 +0530

I guess the primary objective of any technical document is to present
information in a manner that is simple and easy to understand. Any document,
regardless of the complexity of its subject, having more than four levels
has a problem with its structure. It may require a lot of thought and
ingenuity, but I guess a technical writer should have the ability to put
across information within the four levels. One way of dealing with complex
topics, which seemingly require more levels, is by making use of styles,
boxes, notes, tables, fonts, colors, and other such features.

Raj


On 10/13/07, Ned Bedinger <doc -at- edwordsmith -dot- com> wrote:
>
> Butler, Darren J Ctr 584 CBSS/GBHAC wrote:
> >
> > The general rule for most military documents is a primary heading with
> > no more than 4 subordinates. The philosophy is this; if the information
> > is well-organized, you shouldn't need a 5th level.
>
> The philosophy is a suggestion (in the hypnotic sense) that we writers
> let the readers do some of the work of understanding what they read. It
> serves as a reminder that (some) audiences have very plastic
> intelligence--they'll get their heads around many levels of depth beyond
> 3 or 5, even when the deep information is structured and presented as
> only 3 or 5 levels of information in the document they're reading.
>
> So anyway, I think the levels limit is one of those rare and beautiful
> insights into the cognitive abilities that accompany reading skills. At
> least on this point, we can lay down the burden of guiding readers every
> micro-step of the way :-)
>
>
> Ned Bedinger
> doc -at- edwordsmith -dot- com
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> 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.
> http://www.DocToHelp.com/TechwrlList
>
> True single source, conditional content, PDF export, modular help.
> Help & Manual is the most powerful authoring tool for technical
> documentation. Boost your productivity! http://www.helpandmanual.com
>
> ---
> You are currently subscribed to TECHWR-L as raj -dot- machhan -at- gmail -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/raj.machhan%40gmail.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.
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! 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.


Follow-Ups:

References:
How many levels of indents and heads are reasonable?: From: Van Laan, Krista
RE: How many levels of indents and heads are reasonable?: From: Butler, Darren J Ctr 584 CBSS/GBHAC
Re: How many levels of indents and heads are reasonable?: From: Ned Bedinger

Previous by Author: Re: Getting an Entry-Level Tech Writing Job
Next by Author: Re: How many levels of indents and heads are reasonable?
Previous by Thread: Re: How many levels of indents and heads are reasonable?
Next by Thread: Re: How many levels of indents and heads are reasonable?


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


Sponsored Ads