Lucene's API in inconsistent.

It would be great, if some people could unite to solve this problem.

Proposed steps to achieve API consistency:



Let's go


1) Identify categories of inconsistencies and define solutions

Containers don't use Iterable<...> (or more concrete interfaces)

Example:

Why is it bad?

Solution:

Public accessible fields

Example:

Why is it bad?

Solution:

Some methods which return values are named something() others are named getSomething()

Example:

Why is it bad?

Solution:

Some methods don't follow standard Java naming guidelines

Example:

Why is it bad?

Solution:


2) Identify concrete inconsistencies including their occurrences

TODO


3) Examine, which components would be affected by possible refactoring

TODO


4) Propose patches for refactoring

TODO



former bug report, which led to creation of this wiki page: https://issues.apache.org/jira/browse/LUCENE-1439