Hi, As promised, here is an explanation of where we are and where we go next.
HttpCore and HttpClient have been updated to publish their documentation generated from source to: http://hc.apache.org/components/httpcomponents-core-5.1.x/LATEST and http://hc.apache.org/components/httpcomponents-client-5.0.x/LATEST At any time, during SNAPSHOT development or at release staging time, documentation can be: 1. generated from source code: mvn site site:stage 2. then published to LATEST directory: mvn scm-publish:publish-scm by any team member (once initial directory creation in svn will be ok [1]) Integration of this documentation to the main site requires to merge next PR: https://github.com/apache/httpcomponents-website/pull/9 It will create symbolic links that will inject content in normal website directories (without the "/components/" parts that seems strange, explanation will follow...) When you'll do a release, the release manager will publish the documentation and provide "LATEST" url, for review during the vote. Once the vote will be ok, the state of the staging documentation will have to be marked as a release: this will be done with a "svn cp" command, like shown in the website PR [2] Why this components/ directory? The html website consists of the main website "unversioned" content and the documentation generated from source (LATEST and every release that the project will want to keep online). If you build unversioned website and look at "target/site", you'll see that the content is 1,112 kB for 75 files. But if you look at the content in svn [3], there are currently 51,740 files for 1,071,288 kB: there is documentation for each component branch, and that documentation will grow in the future with LATEST and every release Then the website publication job on Jankins [4] will in the future svn checkout more and more content to update only these 75 files that are the unversioned content. Separating documentation in a separate directory of the site is a first step to fix this scalability issue: in a second step, we'll move this svn directory to a location that is fully separate, then won't be checked out by website publication job. I hope this explanation helps everybody understand how release documentation will be published easily and kept as much as you need. Regards, Hervé [1] https://github.com/apache/httpcomponents-client/pull/280 [2] https://github.com/apache/httpcomponents-website/pull/9/files#diff-750296db9b9b33a71f10fa5eda497d2aabe583aad8be1b87a5ea2bb89957bcdf [3] https://svn.apache.org/repos/asf/httpcomponents/site/ https://svn.apache.org/viewvc/httpcomponents/site/ [4] https://ci-builds.apache.org/job/HttpComponents/job/HttpComponents%20Website/ --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
