RE: DOCBOOK-APPS: Help project structure

From
<>
Date
2002-01-29T19:01:56+00:00
ID
3906C56A7BD1F54593344C05BD1374B1053EB487@SUS-MA1IT01
Thread
RE: DOCBOOK-APPS: Help project structure
> -----Original Message-----
> From: Maggie Strevell [mailto:]

>  I am using a section to represent each help topic.  The type 
> of driver file (book|chapter|section).

This looks sensible to me. How come some people recommend article instead of
chapter? Is there some advantage I'm missing?

>  <!-- the file name for the first file in this chapter is 
> generated using the id for the chapter -->

Does 'first file' mean the first section? With recursive sections, you could
have a topic with subsections like this, right?

   <section>
      content...
      <section>Subsection 1...</section>
      <section>Subsection 2...</section>
      <section>See also...</section>
   </section>

The problem with this scenario is that I don't see how to control chunking:
I'd want the whole structure above to be one topic, chunking only the top
section. Do you know how one would suppress chunking in the subsections?

Thanks,
Denis