We have @hsearch.experimental flags on some relatively old features:

• @Facet/@Facets (2015-05)
• DeleteByQuery (2015-03)
• @Indexed.interceptor and EntityIndexingInterceptor (2014-11)
• DocumentExtractor.getTopDocs (2014-03)
• Methods to pass instances in programmatic mappings (2013-09)
• ShardIdentifierProvider (2013-09)
• ProjectionConstants.DOCUMENT_ID (2013-04)
• Every spatial-related annotation (2012-06)
• IndexControlMBean (2010-08)

We should consider either adding tickets about improving these features (if they are not satisfying as they are now) or dropping the experimental flag.

Also, we have these flags on relatively new features, but no information in the code as to when the flag will be dropped or when the API will be reviewed:

• MetadataProvidingFieldBridge, FieldMetadataBuilder et al. (2015-11)
• IgnoreAnalyzerBridge (2016-04)
• IndexManagerTypeSpecificBridgeProvider (2016-04)
• AnalyzerExecutionStrategy (2016-05)

Maybe adding a JIRA key next to every @hsearch.experimental flag (and next to every one we add in the future) would help tracking those?