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 _______________________________________________ gnome-doc-list mailing list [email protected] http://mail.gnome.org/mailman/listinfo/gnome-doc-list
