[LUCENE-4894] Facet User Guide for lucene 4.2 has deleted classes/methods and needs more explanations.

• Type: Bug
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 4.2
• Fix Version/s: 4.5, 6.0
• Component/s: general/website, modules/facet
• Lucene Fields: New, Patch Available
• Assignee: Shai Erera
• Reporter: anonymous
• Created: 01/Apr/13 09:05
• Updated: 28/Aug/22 13:42
• Resolved: 19/Jul/13 22:04

Description

• Concurrent Indexing and Search
  There is no clear explanation regarding those points below.
  1. TaxonomyReader should be reopened after IndexReader.
  2. TaxonomyWriter should be committed before IndexWriter. TaxonomyWriter should be closed before IndexWriter.
  The rationale is that it's ok to see categories to which no document belongs but not ok the other way around.
  Beginners may not be able to see this until after they think through it for a long time, which most of them including me wouldn't do.
  However, facet user guide doesn't explain the rationale clearly.

• DocumentBuilder & FacetSearchParams.addFacetRequest
  They no longer exist in lucene 4.2, but they are used in code examples.

• FacetResultNode.getLabel(TaxonomyReader)
  It doesn't eixst in 4.2, but it is mentioned in "Multiple Facet Requests"

• ETC
  I don't know if there are other points to be made.

Issue Links

• duplicates: LUCENE-5142 Lucene's Facet UserGuide HTML file is out of date