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

Subject: Re: How many levels of indents and heads are reasonable?
From: "heidi arnold" <heidi -dot- w -dot- arnold -at- gmail -dot- com>
To: "neilson -at- windstream -dot- net" <neilson -at- windstream -dot- net>
Date: Wed, 10 Oct 2007 20:04:56 -0400

this may be a non-sequitur, but fwiw, my work meets all the standards
for which it is designed. at least as i have interpreted and applied
these things according to my work. however i do not feel required to
prove such things in an ad-hoc public forum. for one reason, the
audience is not receptive, and there is no true forum for dialogue
about the more difficult areas.

heidi

On 10/10/07, neilson -at- windstream -dot- net <neilson -at- windstream -dot- net> wrote:
> I agree, only more so. I think that a limit of three levels is better.
> When you hit that fourth level, YOU may be able to keep in mind where
> you are, but your reader cannot. The material needs to be restructured.
> Perhaps a whole new chapter or eight are needed.
>
> The only exception is when the documentation is "shelfware". If you can
> be nearly completely sure that no one is ever going to read the stuff,
> and its sole purpose is to fulfill a pointy-haired requirement, then
> all you need do is have it appear to meet standards.
>
> Darren Butler writes:
>
> > Krista Van Laan wondering about: Current thinking on heading levels.
> > Can it all be done with 4 levels, or do we need 6 or more?
> >
> > 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. This forces the
> > author to either combine similar sub-chunks of data into a higher
> > heading or create an additional category/heading that would hold all of
> > the sub-chunk headings. This especially applies to procedural
> > information and other instances where a flow of thought is critical.
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> 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 heidi -dot- w -dot- arnold -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/heidi.w.arnold%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.
>
>


--
www.heidiarnold.org
www.peaceraptor.blogspot.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 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.


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

Previous by Author: Re: Spaces after full stop
Next by Author: Re: Information Graphics "training"?
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