[
https://issues.apache.org/jira/browse/SOLR-10361?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15946993#comment-15946993
]
Uwe Schindler commented on SOLR-10361:
--------------------------------------
Hi the issue here is:
The RM of Lucene and Solr hast to upload the Javadocs/Documentation to the web
page. Currently he has to build the release and then copy away the javadocs
files from the build folders. When the vote has succeeded he would commit the
javadocs to web page.
Previously this was done by using the already voted on tar.gz binary releases,
where the docs folder was extracted and uploaded to Website SVN. No the
javadocs have to be preserved manually and we cannot vote on them (layout,
design issues). So the idea was to just pack them during the release process so
we can vote on them and its easier for the RM to publish them on the web site.
We already publish javadocs maven artifacts, but only per module:
[http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.apache.solr%22%20AND%20a%3A%22solr-core%22]
Those are only for IDEs to show it in Maven/Gradle projects automatically. The
Maven-Javadocs are not useful for browsing, as many information is
missing/broken (like inter-module cross-links).
> Add a solr-docs.tar.gz file
> ---------------------------
>
> Key: SOLR-10361
> URL: https://issues.apache.org/jira/browse/SOLR-10361
> Project: Solr
> Issue Type: Sub-task
> Components: documentation
> Reporter: Uwe Schindler
>
> On SOLR-9450 we decided to add a separate documentation package to the Solr
> downloads. I did something similar for forbiddenapis, too. This docs.tar.gz
> file should contain Lucene and Solr Javadocs.
> This would solve the following problems:
> - People can still download Javadocs, if they like to browse them offline,
> but it won't blow the release
> - The release manager has an easier job to push them to the website. The
> current process broke by SOLR-9450.
--
This message was sent by Atlassian JIRA
(v6.3.15#6346)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
