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

["M. Wroth" <mark at astrid dot upland dot ca dot us>]

At 01:08 PM 8/4/01 +0200, Holger Rauch wrote:

[...]
>There seem to be two choices when it comes to <*list> elements
>(<itemizedlist>, <orderedlist>, etc.).
>
>My questions:
>
>1. Which of the following two ways is the "right" way to do this?
>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)?
[...]

WRT 1, I would argue that both are correct; the list goes inside the 
paragraph if it is logically part of the paragraph, and follows it if it is 
a new thought.  Not a markup issue (except in that the markup should 
support both uses); the question is one for the author and is expressed in 
terms of intent.

My test for this, BTW, is to mentally rewrite the list as a sentence.  If 
that sentence is part of the paragraph, so is the list.  If it starts a new 
paragraph, the list is not part of the paragraph.

Because of this, I find <para> inside <listitem> distracting, and would 
prefer it if they were not needed (for an example of how I would arrange 
things, consider how revision documentation is handled).



Mark B. Wroth
<mark@astrid.upland.ca.us>


------------------------------------------------------------------
To unsubscribe from this elist send a message with the single word
"unsubscribe" in the body to: docbook-request@lists.oasis-open.org