Re: DOCBOOK: <*list> In or After <para>?

[Norman Walsh <ndw@nwalsh.com>]

/ Holger Rauch <Holger.Rauch@heitec.de> was heard to say:
| 1. Which of the following two ways is the "right" way to do this?

There is no "right" way. There are two styles and DocBook allows both.

One school of thought says that if the list is intrinsically part of
the thought of the paragraph, it should be in the paragraph. Otherwise
it should be after.

Another school of thought says that block elements inside paragraphs
are bad. In particular, the fact that HTML doesn't allow block
elements in paragraphs means that if you put them there in DocBook you
sometimes wind up with invalid HTML documents after transformation.

So, practically speaking, although I belong to the first school of
thought, I often do the second.

| 2. Is it desirable to use <para>s inside <listitem>s or should one try to
| use just <listitem>s (without the <para>s inside)?

Did you mean list elements inside paras? You can't put free text inside
a <listitem>.

                                        Be seeing you,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com>      | If you run after wit you will
http://www.oasis-open.org/docbook/ | succeed in catching
Chair, DocBook Technical Committee | folly.--Montesquieu