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

["Dori Green" <dgreen -at- associatedbrands -dot- com>]

John Posada wrote:

I propose that you can define the number of levels you want to stay
within, then structure your documentation to fit within that definition
(and I think this is pretty much a mandatory definition when you are
defining your DITA schema). 

**************

Yes, yes, yes!  Not too long ago I was asked to "document" (it's a noun,
guys) a great big, unbelievably complicated, database system.  One day
of going through the sixteen boxes of information clearly showed that
what was really needed was three sets of documentation separated by
audience:

1 - day-to-day users who needed the down-and-dirty details

2 - supervisors of those day-to-day users so they could set realistic
performance measurements for their subordinates

3 - insanely busy upper-level managers who needed to know the most basic
facts only, but needed enough detail about the system so that they could
answer stockholders' questions with some intelligence

Each set of documentation was usable, and was actually used.

Dori Green
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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.