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
<>
