On 04/07/18 02:18, Huxing Zhang wrote: > Hi, > > On Wed, Jul 4, 2018 at 1:02 AM, Andrea Del Bene <[email protected]> wrote: >> Hi Dubbers! >> >> I know you are super busy-at the moment, but I'd like to add to your TODO >> list a task to host Dubbo JavaDoc on your Apache site. At the moment >> JavaDocs are available at http://www.javadoc.io but it would be nice to >> host them in-house. Normally this is done on the CI server at the end of >> the build coping javadoc files to the site server. > > Welcome! > > +1 to host them in-house, I saw tomcat's Javadoc hosting on the > official site[1]. > > Actually the Javadoc files are generated in Travis CI for every > commit, but I am not quite sure how to sync these files to the site > server. > > Maybe there is not enough privilege for a 3rd-party service to have > write access to apache repositories. > > Do you have any experience on how to achieve that?
The Tomcat docs (including the Javadoc) are only updated (effectively manually) when we do a release so they always refer to the latest release of each branch. If you publish docs from the CI server then you run the risk of the docs and the latest release getting out of sync and that can cause user confusion. Other projects publish the docs for the latest release and the docs for the current development HEAD in separate areas on their website. If you want to publish from CI to the project website you'll need to do that from an ASF owned CI system. Mark > > > [1] http://tomcat.apache.org/tomcat-8.5-doc/api/index.html > >> >> Thank you in advance >> >> Andrea Del Bene. >> Apache Wicket committer. > > >
