I understand but since the facet module was (and still is) experimental, we were also experimenting w/ its APIs and ways to simplify them. The userguide was a mess - while valuable to newcomers, it was impossible to keep it up to date with the API changes ever since it was contributed to Lucene. The facet module has gone under two major overhauling since 3.4, both for good reasons (performance and API simplification). It was way outdated and users complained about that too.
Given that, we've decided to remove it and suffice with blog posts, some of which are already outdated too, and best of all is the demo code. If you have specific questions on how to migrate to the new API, I would be happy to assist you. But I don't think we'll write another userguide. Also, if you can point to missing jdocs or places where they could be improved, please open a JIRA issue and I'll help as much as I can with that too. Shai On Mon, Jun 16, 2014 at 7:15 PM, Nicola Buso <nb...@ebi.ac.uk> wrote: > Hi Shai, > > I'm going to update from 4.6.1 to 4.8.1 :-( > > On Wed, 2014-06-11 at 14:05 +0300, Shai Erera wrote: > > Hi > > > > We removed the userguide long time ago, and replaced it with better > > documentation on the classes and package.html, as well as demo code that > > you can find here: > > > https://svn.apache.org/repos/asf/lucene/dev/branches/lucene_solr_4_8/lucene/demo/src/java/org/apache/lucene/demo/facet/ > > where is the documentatation on packages? > > http://lucene.apache.org/core/4_8_1/facet/org/apache/lucene/facet/package-summary.html > > http://lucene.apache.org/core/4_8_1/facet/org/apache/lucene/facet/range/package-summary.html > > http://lucene.apache.org/core/4_8_1/facet/org/apache/lucene/facet/sortedset/package-summary.html > > http://lucene.apache.org/core/4_8_1/facet/org/apache/lucene/facet/taxonomy/package-summary.html > > http://lucene.apache.org/core/4_8_1/facet/org/apache/lucene/facet/taxonomy/directory/package-summary.html > > this is nothing compare to: > > http://lucene.apache.org/core/4_4_0/facet/org/apache/lucene/facet/doc-files/userguide.html > > I know, I can still learn from the demo code... but if I'm not starting > from scratch it's not that straight forward to migrate. > > If I'm right most of the changes are because of: > https://issues.apache.org/jira/browse/LUCENE-5339 > > that's a long thread of discussions on what happened but a bit confusing > to recap. Is there any migration guide on this? > > > > Nicola. > > > You can also look up some blog posts that I wrote a while ago on facets, > > that explain how they work and some internals, even though the code > > examples are not up-to-date w/ latest API changes: > > > > http://shaierera.blogspot.com/2012/11/lucene-facets-part-1.html > > http://shaierera.blogspot.com/2012/11/lucene-facets-part-2.html > > http://shaierera.blogspot.com/2012/12/lucene-facets-under-hood.html > > http://shaierera.blogspot.com/2013/01/facet-associations.html > > > > Shai > > > > > > On Wed, Jun 11, 2014 at 10:51 AM, Raf <r.ventag...@gmail.com> wrote: > > > > > Hi, > > > I have found this useful guide to the "*Lucene Faceted Search*": > > > > > > > http://lucene.apache.org/core/4_4_0/facet/org/apache/lucene/facet/doc-files/userguide.html > > > > > > The problem is that it refers to Lucene version 4.4, while I am using > the > > > latest available release (4.8.1) and I cannot find some classes (e.g. > > > FacetSearchParams > > > or CountFacetRequest). > > > > > > Is there an updated version of that guide? > > > I tried this > > > > http://lucene.apache.org/core/*4_8_1*/facet/org/apache/lucene/facet/doc-files/userguide.html > > > but it does not work :| > > > > > > Thank you for any help you can provide. > > > > > > Regards, > > > *Raf* > > > > > -- > Nicola Buso > Software Engineer - Web Production Team > > European Bioinformatics Institute (EMBL-EBI) > European Molecular Biology Laboratory > > Wellcome Trust Genome Campus > Hinxton > Cambridge CB10 1SD > United Kingdom > > URL: http://www.ebi.ac.uk > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: java-user-unsubscr...@lucene.apache.org > For additional commands, e-mail: java-user-h...@lucene.apache.org > >
