[
https://issues.apache.org/jira/browse/LUCENE-7964?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16461809#comment-16461809
]
Robert Muir commented on LUCENE-7964:
-------------------------------------
I think this issue shouldn't try to explode the scope into documenting all
possible parameters, autogenerating them, making them type-safe, or any other
stuff.
This stuff is really just blocking all progress when it needs to be separate
stuff, because we don't have that today.
What we have today is nonfunctional javadoc for java users, which is a real
problem, e.g.
https://mail-archives.apache.org/mod_mbox/lucene-java-user/201805.mbox/%3CCANdt40C_q8GX2_E9b%2B_qORZKojWANPfT%3DnzMuRg02WB3mbZe1w%40mail.gmail.com%3E
I think instead the lucene javadocs here really need to use examples that,
well, work with lucene: e.g. reformulated with CustomAnalyzer.
> Remove Solr fieldType XML example from Lucene AnalysisFactories JavaDoc
> -----------------------------------------------------------------------
>
> Key: LUCENE-7964
> URL: https://issues.apache.org/jira/browse/LUCENE-7964
> Project: Lucene - Core
> Issue Type: Improvement
> Components: general/javadocs
> Reporter: Jan Høydahl
> Priority: Trivial
> Fix For: 7.4, master (8.0)
>
>
> As proposed and discussed in this dev-list thread:
> https://lists.apache.org/thread.html/9add7e4a3ad28b307dc51532a609b423982922d734064f26f8104744@%3Cdev.lucene.apache.org%3E
> [~rcmuir] [~dsmiley] [~thetaphi]
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
