[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: ozoneUML

I will be off for some days, so you have to go ahead without me. Anyway,
seems that you guys don't need my help with the Ozone Documentation Project
anyway ;) Points that should be done next:

- Lars will setup CVS monday

- committers: Per, Eric, Yanick? Others? Comments?

- at first, committers should write and agree on a document that describes
general doc writing styles, who is responsible for what, who commits what,
things like that

- I believe that Lars could setup a StyleBook environment pretty fast but it
seems that Eric has something working too. Please discuss this.

- separation into user, developer, admin docs sounds good

- having fun


Falko


On Fri, 25 May 2001, Eric Richardson wrote:
> Sean Allen wrote:
> > 
> > On 25 May 2001 13:58:01 +0200, Per Nyfelt wrote:
> > > > the GDP has a good white paper on
> > > > contributing that makes good reading for any wanting to get involved in
> > > > any kind of open-source doc effort.
> > > > (http://developer.gnome.org/gdp)
> > >
> > > The link seems to be broken (at least i cannot find a page there)
> > ooops, my error, the real link is here
> > 
> > http://developer.gnome.org/projects/gdp/handbook.html
> > 
> Hi Sean, Per, Falko ...
> 
> Check out Docbook prototype thread which uses XML and the Java tools
> (ant, xalan, xerces, Fop) which is much more closely aligned with the
> tool set used in Ozone.
> SGML uses the DSSSL stylesheet and Jade for transformation etc. The
> supplied prototype uses all Java tools and XML for docbook - let me know
> if it works - I can't test it on windows either.
> 
> > >
> > I can put some time into it, but I think we will have to drill down to
> > exactly what we want in each, before I start.
> > so, what should we put into the
> 
> > 1) developers
> There are several threads on the list where Falko and other knowledgable
> people have given excellent commentaries on how transactions,
> clustering, persistence and other things work in ozone. I pasted some of
> these in the ozone.xml docbook sample in the prototype which could
> server as a starting point for the developer guide.
> 
> > 2) users
> I'd like to do this one - if no one objects - and I thought I'd start
> with the existing documentation and go from there.
> 
> 3) admin
> performance, clustering params, VM args and analysis, backup, recovery
> etc.
> 
> Eric
-- 
______________________________________________________________________
Falko Braeutigam                              mailto:falko@smb-tec.com
SMB GmbH                                        http://www.smb-tec.com