cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ralph Goers <Ralph.Go...@dslextreme.com>
Subject Re: [Vote] Doc format for release
Date Mon, 17 Oct 2005 13:23:03 GMT


Carsten Ziegeler wrote:

>As our documentation is now managed by Daisy, we don't have the docs in
>the source repository anymore. For the release we should include docs in
>the distributions.
>
>It seems to me that we have three choices (please correct me if I'm wrong):
>
>1) a PDF of the whole doc
>2) a set of HTML files
>3) Both
>
>So please vote on what we should use - I think the majority simply wins.
>
>I think if we're using a PDF file we can just copy this into our source
>tree, but for HTML we should just use an svn external that points to the
>generated site doc.
>
>Carsten
>  
>
A PDF file is certainly easier to ship, but can be hard to read.  I 
would definitely be -1 on javadoc in PDF.

However, I could live with a Cocoon PDF "book" and the javadoc as html. 

Given just the choices above I'd vote for 2 or 3.

Ralph

Mime
View raw message