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

Re: Ozone Doc Project

yduchesne wrote:
> 
> At 08:51 PM 5/25/01 +0200, you wrote:
> 
> Well, I am pretty suprised by the reaction about the Ozone Doc Project. I
> thought no one would would be interested(except me!!!!). Anyway, I' have
> previously submitted a draft on what the project's dynamics could be. I can
> post it again if anyone has missed... Has anyone got any comments about it?
> Does it sound OK? Keep in mind, I'm the last person here who would want to
> impose anything... All guys on the list seem like seasoned experts with
> Ozone... I'm just a rookie!
> 
> Cheers.
> 
> Yanick

No this is great - I had just finished passing some diffs on the current
docs to Falko and was planning on working on the user doc. What you said
so far is great. Can you try out what I put together and let me know how
it works? Maybe one of the current experienced developers can coordinate
and facilitate to keep us newbies on track. Maybe Per can be lead since
he has already wrote a hacking guide.

Are you on UNIX as I put together the tools on Linux so I don't know
what will happen on the Win side.

Eric

> 
> >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