incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Michael Wechner <michael.wech...@wyona.org>
Subject Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html
Date Tue, 18 Mar 2003 23:24:29 GMT
Nicola Ken Barozzi wrote:

>
> Rodent of Unusual Size wrote, On 18/03/2003 20.56:
>
>> if the documentation is easily generated from a cvs checkout
>> using tools any user will have available, not putting the
>> generated files in cvs *might* be an option.  if building
>> the docco requires either specialised tools or knowledge,
>> the docco should be under cms control.  mho after doing
>> this shite for twenty years.
>
>
> I agree that putting generated stuff in CVS sucks big time.
> The point is that users and developers like having these on the site.
>
> For example, I might need the docs but have only the jar ATM, or I 
> want to explain a thing on the list with a link to the javadocs.
>
> Anyway, a solution for Java projects seems simple: make the project 
> run under Gump, and these generated files will be published daily.
> But this gives us the latest docs, not the ones of the last release.
>
> So IMHO we should push these docs to the site by hand and not use the 
> site CVS for it.


IMHO what you need is a "CMS" ;-)

Nicola, please apologize my remark, but I just couldn't help it.

btw, the Lenya docs are now based (thanks to Gregor) on document-v11.dtd

All the best

Michael



---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Mime
View raw message