Thanks Shawn, these are neat tricks. I did find a couple of similar tricks with the versions. But I keep forgetting them and sometimes even that does not help.
Additionally, the way Javadocs are built, the cross-links do not work too well. The classes are split between build modules and if you want to go up and down the inheritance hierarchy that spins multiple modules (or Solr/Lucene divide) you do not even get told those classes exist. So, it becomes a case of knowing that it exists to look for it. I am not saying it is terrible, just that perhaps it can be made better. And I want to experiment with making it better. So I need a freedom to experiment faster than official release policy. Regards, Alex. P.s. I am not a SEO expert either. Once I learn to be one with this and/or other projects, I would be more than happy to contribute my skills back to the official documentation. Personal website: http://www.outerthoughts.com/ LinkedIn: http://www.linkedin.com/in/alexandrerafalovitch - Time is the quality of nature that keeps events from happening all at once. Lately, it doesn't seem to be working. (Anonymous - via GTD book) On Fri, Mar 7, 2014 at 4:32 PM, Shawn Heisey <[email protected]> wrote: > On 3/6/2014 8:42 PM, Alexandre Rafalovitch wrote: >> I asked this on Apache legal list but got no reply. So, I thought I'll >> try again for the group it will affect directly (project not mentioned >> below is Solr). >> >> Any opinion on legality, usefulness or possibly underlying causes of >> the original problem would be appreciated. >> >> Regards, >> Alex. >> ---------- Forwarded message ---------- >> Date: Thu, Feb 27, 2014 at 4:41 PM >> Subject: Am I allowed to generate, enhance and republish a JavaDoc of >> an Apache project? >> To: [email protected] >> >> >> Hello, >> >> For one (of many) of the Apache projects that I use, I am very >> frustrated that Google cannot find the officially-hosted Javadocs. > > I'm not going to try to comment about the legal issues, but I will tell > you that I can very often find javadocs for a very specific class by > searching for it along with a specific recent version number. So I will > google for 'HttpSolrServer 4.7.0' and I have what I need. Finding > related things is normally pretty easy, because there are clickable > links for related classes buried in any given javadoc page. > > When searching for recent docs for SolrQuery, if I leave out the version > number, I only get 4.2.1 and 3.6.0 near the top of the results. If I > add a version number, the top results are actually kinda useless. A > search for 'SolrQuery 4.6.1 API' did the trick. It's simply too common > a phrase, especially when broken apart into Solr and Query. > > There are very likely things that we can do to improve our search engine > results. I'm not well versed in SEO myself. > > Thanks, > Shawn > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
