cxf-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Hani Suleiman <h...@formicary.net>
Subject Re: Wiki and Web
Date Thu, 24 Aug 2006 22:17:12 GMT
Yep, makes sense to me.

On Aug 24, 2006, at 6:12 PM, Johnson, Eric wrote:

> 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