[ https://issues.apache.org/jira/browse/LUCENE-1897?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12754480#action_12754480 ]
Mark Miller edited comment on LUCENE-1897 at 9/11/09 10:05 PM: --------------------------------------------------------------- I guess. bq. if we had a refrence to a jar file in a README or an html page we wouldn't consider it a bug that people couldn't find that jar file in a source release I dunno - perhaps. If the README said, you will find this jar at /lucene/jar and then I go to /lucene/jar and nothing is there, I would personally find that a bit confusing. But it wouldnt bother me too much I guess. But if I open the site HTML in the folder docs, and most of the links are broken cause they point to javadoc - that seems broken to me. Whether we want to fix it or not, I don't know and I don't have a real suggestion - but certainly seems like a bug when we distribute a bunch of docs in a doc folder with a bunch of broken links. * edit * Unless it says somewhere - by the way - the doc folder will contain a bunch of broken links until you build the javadocs - that would convince me otherwise. I'm not super concerned either way - you can feel free to close - it was more to flag a discussion than anything I'm personally vested in. To me, downloading to view the source, and then looking through the docs, I'd be confused when the links didn't work - but that doesn't mean anything has to change. was (Author: markrmil...@gmail.com): I guess. bq. if we had a refrence to a jar file in a README or an html page we wouldn't consider it a bug that people couldn't find that jar file in a source release I dunno - perhaps. If the README said, you will find this jar at /lucene/jar and then I go to /lucene/jar and nothing is there, I would personally find that a bit confusing. But it wouldnt bother me too much I guess. But if I open the site HTML in the folder docs, and most of the links are broken cause they point to javadoc - that seems broken to me. Whether we want to fix it or not, I don't know and I don't have a real suggestion - but certainly seems like a bug when we distribute a bunch of docs in a doc folder with a bunch of broken links. * edit * Unless it says somewhere - by the way - the doc folder will contain a bunch of links until you build the javadocs - that would convince me otherwise. I'm not super concerned either way - you can feel free to close - it was more to flag a discussion than anything I'm personally vested in. To me, downloading to view the source, and then looking through the docs, I'd be confused when the links didn't work - but that doesn't mean anything has to change. > Links to javadoc from the site pages do not work in the src dist because it > does not include the javadoc under docs. > -------------------------------------------------------------------------------------------------------------------- > > Key: LUCENE-1897 > URL: https://issues.apache.org/jira/browse/LUCENE-1897 > Project: Lucene - Java > Issue Type: Bug > Components: Javadocs > Reporter: Mark Miller > Priority: Minor > Fix For: 2.9 > > > Links to javadoc from the site pages do not work in the src dist because it > does not include the javadoc under docs. -- This message is automatically generated by JIRA. - You can reply to this email to add a comment to the issue online. --------------------------------------------------------------------- To unsubscribe, e-mail: java-dev-unsubscr...@lucene.apache.org For additional commands, e-mail: java-dev-h...@lucene.apache.org