converted another short section to bullet points

This commit is contained in:
emmajane 2004-01-06 07:30:40 +00:00
parent 33db7e8a57
commit 4af8ba1038
1 changed files with 19 additions and 9 deletions

View File

@ -6,19 +6,27 @@
<title>DocBook: Sample Markup</title>
<section id="writing-docbook">
<title>Writing With DocBook Elements</title>
<title>General Tips and Tricks</title>
<indexterm zone="writing-docbook">
<primary>edition</primary>
<secondary>using DocBook</secondary>
</indexterm>
<para>
For a general overview of what markup is all about, please read <xref
linkend="ag-markup" />
</para>
<itemizedlist>
<listitem>
<para>An editor capable of inserting elements according to the
<acronym>DTD</acronym> will help a lot since it will enforce
the DTD.
This way you can be sure that no invalid elements were added
anywhere in your document.</para>
</listitem>
<listitem>
<para>In order to ensure that future changes are as easy as possible,
authors should try to keep compatibility with
the <acronym>XML</acronym> version of the DocBook DTD. This means
@ -26,13 +34,15 @@
attributes, and not omitting end tags. Most tools that
automatically insert elements (like psgml+emacs) follow these
rules automatically or with some fine tuning.</para>
<para>Each type of document created has a specific structure,
and examples of documents can be found in the <xref
linkend="templates" />.</para>
<para>Considering the explanation above we can proceed to instructions on
how to write a document using DocBook.</para>
</listitem>
<listitem>
<para>Each type of document created has a specific structure. This
document is in <quote>book</quote> format. Most authors, however, will
want to use the shorter <quote>article</quote> format instead.
Templates are available from <xref linkend="templates" />.
</para>
</listitem>
</itemizedlist>
<section id="useful-markup">
<title>Useful markup</title>