Re: [Hibernate-devel] Documentation in DocBook

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

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

> I need more time to think some of the reordering through .... the
> previous order was designed to get people started as quick as
> possible ... topics went from "basic" to "advanced". The new
> ordering is much more by subject which makes it more readable
> for most users but perhaps harder for brand new users just
> getting started. Anyway, I will put some thought into this and
> perhaps suggest some further changes.

My initial intention was to provide a complete reference documentation
for all features. One of the next steps would be to provide "Quickstart"
documentation for different scenarios. But I don't think this should be
_in_ the reference documentation.

> cool. unfortunately I'm having trouble checking this stuff out of CVS.
> Are you sure you checked in all the binary files with -kb?

Gah, used -ko, my fault. I think this can be fixed with a cvs admin -kb
command?

> I would very much prefer Ant if its at all possible. I've finally
> started using the ant build script to generate javadoc, etc, So
> it would be really nice to integrate this stuff with the existing
> stuff. My dream is to eventually be able to do a whole release
> with just a single Ant task but I'm not there yet ;)

OK, I will try Ant.

> yes, I would like to do this stuff for 1.0.2 if possible, since I want
> to document the new 1.0.2 features in docbook. Could you tell me
> exactly how up to date the docbook text is compared to the aft text? I
> did make a couple of minor changes this week and I might need to copy
> them over.

You will need to add your changes, the converted version is more than a
week old.

P.S. I'm subscribed to the devloper list, no need to Cc. :)

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