I think it is more important to document all parameters and their valid values than to give one specific example of how to setup a complete analyzer. We could add a <dl><dt>myparam</dt><dd>description</dd><dt>myparam2</dt><dd>desc</dd></dl>… to each, along with a standard phrase: "See CustomAnalyzer (link) for an example of how to create an Alalyzer with this filter”
-- Jan Høydahl, search solution architect Cominvent AS - www.cominvent.com > 8. sep. 2017 kl. 00.04 skrev Uwe Schindler <u...@thetaphi.de>: > > +1 > > I am fine with both variants. > > Uwe > > Am 7. September 2017 22:10:25 MESZ schrieb Robert Muir <rcm...@gmail.com>: > On Thu, Sep 7, 2017 at 3:58 PM, Jan Høydahl <jan....@cominvent.com> wrote: > Hi, > > Most Analysis factories have a snippet in the JavaDoc providing an example > for how to configure the component in Solr’s schema.xml. > See > http://lucene.apache.org/core/6_6_0/analyzers-common/org/apache/lucene/analysis/miscellaneous/ASCIIFoldingFilterFactory.html > > <http://lucene.apache.org/core/6_6_0/analyzers-common/org/apache/lucene/analysis/miscellaneous/ASCIIFoldingFilterFactory.html> > for an example. > > I feel it is a bit mal-placed, and Solr users can find such XML snippets in > the RefGuide. > The snippet gives information about what options the factory accepts in its > constructor (Map<String,String>), so we should cannot simply delete the XML. > But perhaps it could be replaced by a HTML definition list or table > describing each option? > > > How about we replace with the equivalent example for CustomAnalyzer, > which lets you use them in a programmatic way with the lucene API? > > http://lucene.apache.org/core/6_6_0/analyzers-common/org/apache/lucene/analysis/custom/CustomAnalyzer.html > > <http://lucene.apache.org/core/6_6_0/analyzers-common/org/apache/lucene/analysis/custom/CustomAnalyzer.html> > > > To unsubscribe, e-mail: dev-unsubscr...@lucene.apache.org > For additional commands, e-mail: dev-h...@lucene.apache.org > > > -- > Uwe Schindler > Achterdiek 19, 28357 Bremen > https://www.thetaphi.de <https://www.thetaphi.de/>