Re: [Hibernate-devel] Documentation in DocBook

[Christian B. <chr...@bl...>]

On 25 Jul (14:43), Gavin_King/Cirrus%CI...@ci... wrote:

> 1. currently, all <title> elements are transformed to <h2>. It would be
> much nicer if sect1/title would by rendered as <h3>.

I'll fix that.

> 2. can we get rid of the <p> tags inside <li> in the HTML version? (A minor
> issue, I suppose)

Yes, but only in the stylesheets. The docbook requires a para in a
listitem in XML.

> 3. I think the persistent-classes and basic-or-mapping sections should come
> before the session-configuration section. Otherwise the order seems good.

Hm. My first approach would be to read the "how to get it up and
running; aka configuration" and after that I will look into how to do
basic things. That was my approach when getting in contact with
hibernate and I jumped alot around the documentation to get a basic
"configuration, load, manipulate, store"-cycle going. I think it's
better that way (further down my todo-list is a rewrite and cleanup of the
configuration section).

Of course, if you insist, just move it around.

> I have a long todo-list now so it may take me a couple of days to get round
> to everything.

Me too, I won't have any time until next week, so your changes will be
checked in first.

-- 
Christian Bauer
tu...@in...