[dev] help.xml

[Marko Djukic]

What is the reason behind using xml in the help file? Couldn't the same be
achieved with just simple html markup and css?

eg. instead of:
<entry id="compose-from">
    <title>Message Composition: From</title>
    <heading>"From"</heading>
    <para>
    If enabled by your administrator you can choose from a drop-down list an
identity that you entered under &quot;Options-&gt;Personal Information&quot;,
or you can enter the mail address in a text field that you want to use as the
sender of this message.
    </para>
</entry>

Use something like:
<div id="compose-from">
    <h1>Message Composition: From</h1>
    <h2>"From"</h2>
    <p>If enabled by your administrator you can choose from a drop-down list an
identity that you entered under &quot;Options-&gt;Personal Information&quot;,
or you can enter the mail address in a text field that you want to use as the
sender of this message.</p>
</div>

So you could still extract the right entry from the file for showing a single
help entry or building a table of contents, and there would be no need for XML
parsing and translation to HTML.



--
Marko Djukic
Horde Project (http://horde.org)