dsmiley commented on PR #943: URL: https://github.com/apache/solr/pull/943#issuecomment-1214289465
A big obstacle I'm seeing is split packages between solrj & solrj-zookeeper with respect to javadocs. For example the javadocs for solr-core will now contain broken links to most solrj-zookeeper classes because the javadoc tool can't figure this out (kind of a long-standing deficiency). Personally, I'm not very sympathetic to the needs of continuing to maintain a javadoc site. I don't use them, I doubt others do, and moreover for open-source, really the source is what we want to see because it's better / more. That's me, anyway. I don't think maintaining them is more important than other goals like modularization, and thus I'm willing for there to be some degradation there. Options: * In our javadocs, stop **linking** out to solrj or solrj-zookeeper because they cannot be differentiated by the standard javadoc tool. * Accept broken links; stop checking for them within javadoc folders. * Fix it (not something I'm willing to invest in) Of course in main/10.0 we can remove the split packages but that's a back-combat break that isn't okay for 9.x. CC @uschindler -- I'm curious what you think -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
