[SOLR-2600] ensure example schema.xml has some mention/explanation of per field similarity vs similarityprovider vs (global) similarity

• Type: Task
• Status: Closed
• Priority: Blocker
• Resolution: Fixed
• Fix Version/s: 4.0-ALPHA
• Component/s: documentation
• Assignee: Chris M. Hostetter
• Reporter: Chris M. Hostetter
• Created: 16/Jun/11 00:12
• Updated: 10/May/13 10:41
• Resolved: 26/Jun/12 02:09

Description

when SOLR-2338 was commited, there wasn't yet clear understanding of how much the new feature per field similarity fields (vs custom similarity provider (vs global similarity factory)) should be "advertised" in the example configs, and what type of usage should be encouraged/promoted.

it's likely that by the time 4.0 is released, new language specific field types will already demonstrate these features, and no additional "artificial" usages of them will be needed, but one way or another we should ensure that they are either demoed or mentioned in comments

Issue Links

• is part of: SOLR-3577 better javadocs and error messages related to global/fieldtype SimilarityFactory usage
• is related to: SOLR-2338 improved per-field similarity integration into schema.xml