You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@lucene.apache.org by "Uwe Schindler (Jira)" <ji...@apache.org> on 2019/10/30 22:36:00 UTC
[jira] [Comment Edited] (LUCENE-9014) Design a new solution for
publishing JavaDoc
[ https://issues.apache.org/jira/browse/LUCENE-9014?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16963486#comment-16963486 ]
Uwe Schindler edited comment on LUCENE-9014 at 10/30/19 10:35 PM:
------------------------------------------------------------------
Sorry, I am against relying on an non-ASF controlled service for publishing the documentation of Apache Lucene. The index.html is something that is archived in our artifacts. The links in it should be PERSISTENT, which may not be the case.
If we want to make the publishing of Javadocs easier, IMHO we should use another webserver which can serve files from inside ZIP/JAR files. My favourite is Jetty - it can use a JAR/ZIP file as source for static file delivery (it's a handler). I'd ask Infra, if this is possible. ZIP the build/docs folder and place it in SVN. The delivery of the files is then
The javadoc.io version navigation is just a farme on top of the other framesets. That's easy to do as part of the CMS on our side, too.
was (Author: thetaphi):
Sorry, I am against relying on an non-ASF controlled service for publishing the documentation of Apache Lucene. The index.html is something that is archived in our artifacts. The links in it should be PERSISTENT, which may not be the case.
If we want to make the publishing of Javadocs easier, IMHO we should use another webserver which can server files from ZIP/JAR files. My favourite is Jetty - it can use a JAR/ZIP file as source for static file delivery (it's a handler). I'd ask Infra, if this is possible. ZIP the build/docs folder and place it in SVN. The delivery of the files is then
The javadoc.io version navigation is just a farme on top of the other framesets. That's easy to do as part of the CMS on our side, too.
> Design a new solution for publishing JavaDoc
> --------------------------------------------
>
> Key: LUCENE-9014
> URL: https://issues.apache.org/jira/browse/LUCENE-9014
> Project: Lucene - Core
> Issue Type: Sub-task
> Reporter: Jan Høydahl
> Assignee: Jan Høydahl
> Priority: Major
> Attachments: LUCENE-9014.patch, LUCENE-9014.patch
>
>
> Currently we check in to svn folders with hundreds of html files for JavaDoc. Need a better way.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@lucene.apache.org
For additional commands, e-mail: issues-help@lucene.apache.org