some feedback about mallard after converting gnome-bluetooth

[Baptiste Mille-Mathias <baptiste millemathias gmail com>]

Hello there,

as some of you may know I've just converted the documentation of
gnome-bluetooth using the mallard format.
the repository is
http://gitorious.org/gnome-bluetooth/gnome-bluetooth/commits/mallard-doc

I wanted to take advantage of this to send the problem I encountered, I
certainly mixed bugs falling under yelp, mallard and gnome-doc-utils.

by the way, I'm not really used to write documentation so my comments
are likewise to totally irrelevant.

- <list> cannot be used within <p> markup: it seems weird to me as it
was possible with docbook. So currently I need to close <p> before and
do my list out of the paragraph. Is it a bug?

- no picture is showing up when using <media>: I use something like
<media type="image" mime="image/png" src="figures/bluetooth-applet.png">
<p>The <app>gnome-bluetooth</app> blah foo .....</p>
</media> in various places and no picture is showing up. Do I use
<media> correctly?

- text inside <p></p> inside <media></media> can't be selected (perhaps
not related to mallard).

- I don't like color for <steps>, the blue background doesn't fit in my
dark theme :)

- Will Mallard have a equivalent for question related markup, I always
find convenient to have FAQ in help document. I used one in
gnome-bluetooth docbook format, but I had to drop this part for now.

The mallard format is nice to use, the conversion is quite easy.
I have difficulties to understand the properties explained in the
documentation (perhaps this is exhibited by the fact I don't know
relax-ng).

regards