cxf-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Johnson, Eric" <Eric.John...@iona.com>
Subject RE: Wiki and Web
Date Thu, 24 Aug 2006 22:12:29 GMT
Hani,
I was proposing that developers decide what is the best is the best
format for developer facing docs.
It was the user facing docs that I was proposing the use of Docbook.
Cheers,
Eric

> -----Original Message-----
> From: Hani Suleiman [mailto:hani@formicary.net]
> Sent: Thursday, August 24, 2006 5:53 PM
> To: cxf-dev@incubator.apache.org
> Subject: Re: Wiki and Web
> 
> 
> On Aug 24, 2006, at 5:12 PM, Johnson, Eric wrote:
> 
> > Dan,
> > I was thinking about the user facing docs staying in Docbook
> > specifically because it would make it easier for me to integrate the
> > content into IONA's documentation world. However, Docbook is an open
> > standard and used by other companies and projects for
> > documentation, so
> > it makes it easier for people beyond IONA as well.
> > The developer facing docs should be in a format that is easiest for
> > the
> > developers to create.
> > I guess I see the division in this way:
> > * developer facing docs are geared towards committers and people
> > building CeltiXfire. This would include architectural stuff and the
> > kind
> > of discussions that will happen on the mailing list about how the
APIs
> > should work. They are highly fluid and reflect the code as it is in
> > development.
> 
> Are you proposing docbook for developer facing docs, or wiki?


Mime
View raw message