RE: [architecture] Documentation format

["Colin Crist" <colincrist@xxxxxxxxxxxxx>]

Hi,

Do look at DITA as well:

An example implementation:

http://sourceforge.net/projects/dita-ot

Docs, google for the rest.

http://www.oreillynet.com/pub/wlg/8072?wlg=yes

I know of some internal projects at a bank in the City generating web, java
help and .net help docs out of the XML. 

Nice separation of content and presentation. One day I'd like to use it
myself...

Regards,

Colin.
http://hermesjms.com

-----Original Message-----
From: David Li [mailto:taweili@xxxxxxxxx] 
Sent: 31 January 2006 18:27
To: Architecture Objectweb
Subject: Re: [architecture] Documentation format

I think we had some discussion on the document format a while ago. I am not
sure if it's on the architecture list. There are several proposal but no
conclusive decision. Personally, I think we should at least have some
guideline.

Personally, I'd like docbook XML with support for translation. I have run
both Chinese and Japanese project and the existing document format in HTML
makes it hard to track change in the document for translation.

David

On Feb 1, 2006, at 2:25 AM, Guillaume Sauthier wrote:

> Hi folks
>
> We are wondering if there is some objectweb level directive for  
> documentation format (html, wiki, docbook XML, ...) ?
> I remember there was a discussion about this topic some times ago,  
> but I don't recall if there was a final decision.
>
> Any thoughts ?
>
> Best regards
> Guillaume
> <Guillaume.Sauthier.vcf>
>
> -- 
> You receive this message as a subscriber of the  
> architecture@xxxxxxxxxxxxx mailing list.
> To unsubscribe: mailto:architecture-unsubscribe@xxxxxxxxxxxxx
> For general help: mailto:sympa@xxxxxxxxxxxxx?subject=help
> ObjectWeb mailing lists service home page: http://www.objectweb.org/ 
> wws