incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Paul Hammant <paul_hamm...@yahoo.com>
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 Fri, 21 Mar 2003 13:27:33 GMT
> > can the docs be reproduced locally into the same usable format
> > as they exist on the site, using a tool that anyone reading
> > the docs would automatically have?
> 
> yes.
> 
> with that said, I like having javadocs on a website. For new projects, 
> I will often go look at the online javadocs to get an overview of the 
> code and architecture to determine if I want to go to the effort of 
> downloading it and playing with it further.

It is true. Demonstrated this morning because James emailed me asking for teh api/ link. (Tis
not
in the links).

I think we all agree on the fact that docs on site are good. Where Apache differs from, say,
SourceForge, is when we push the generated docs into CVS. Thats xdocs and javadocs. It would
be
nice to have a forrest-gump-cruisecontrol thing to just get latest docs each night and shove
them
to the /home/www/project/subproject site.

- Paul

__________________________________________________
Do You Yahoo!?
Everything you'll ever need on one web page
from News and Sport to Email and Music Charts
http://uk.my.yahoo.com

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


Mime
View raw message