lists vs procedures WAS: Patch for Kubuntu Desktop Guide: Games Section

[Brian Burger]

On 2/14/06, Jeff Schering <jeffschering at gmail.com> wrote:
> On 2/14/06, Brian Burger <blurdesign at gmail.com> wrote:
> > Actually, in the Ubuntu Desktop Guide, we/I replaced the qandasets
> > with sectX tags (sect1, sect2, etc), and mdke has been replacing our
> > orderedlists with itemizedlists (going from numbered lists to just
> > bullet points, in other words...)
> >
> Procedures such as those found in the common tasks section of the
> desktop starter guide need to be numbered. Bulleted lists are not used
> in procedure steps, and only when the order of list items is not
> important.
>
> Both the orderedlist tag and the itemizedlist tags are not the correct
> tags for procedure steps. Instead, we should be using the procedure
> tag. See  http://www.docbook.org/tdg/en/html/procedure.html and also,
> from the KDE Docbook Authors Guide:
> http://i18n.kde.org/doc/markup/lists.html

Thanks, Jeff. I'm still learning DocBook/XML by hacking other people's
code, and the semantic markup of it still trips me up sometimes.

Links bookmarked, and I'll start changing UDG over later this week.

Brian