[
https://issues.apache.org/jira/browse/LUCENE-3166?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13042018#comment-13042018
]
Shai Erera commented on LUCENE-3166:
------------------------------------
bq. Does anyone have any opinions on this proposal?
Don't know if it counts (since I opened it), but +1 to follow this proposal !
> src/site should not be built under /docs
> ----------------------------------------
>
> Key: LUCENE-3166
> URL: https://issues.apache.org/jira/browse/LUCENE-3166
> Project: Lucene - Java
> Issue Type: Improvement
> Components: general/javadocs, general/website
> Reporter: Shai Erera
> Priority: Blocker
> Fix For: 3.3, 4.0
>
>
> I noticed that the source package contains a "docs" subdir with all the
> site's docs. Also, the root has index.html which nicely points to all those
> documents. However, it also points to the Javadocs which are absent. If you
> "ant javadocs", they are built under build/docs/api, which makes the links in
> index.html still invalid.
> Iterating on it shortly, Robert and I think that the following should be done:
> # have src/site docs built under src/site/build. Today they already are, but
> later "cp -r" under /docs, so we should remove the copy instruction.
> # have "ant docs" or "ant generate-docs" which generates javadocs + copy
> src/site/build under build/docs. Then all links will still work.
> # remove "docs" from svn and keep them under src/site/build.
> Marking it a blocker for 3.3 so we revisit before then.
--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
