MIGRATE/CHANGES.txt need improved Points verbage [LUCENE-7076]

[asfimport]

for MIGRATE.txt, we should have some more verbage, maybe examples of how to index/search a 1D integer. maybe even better, it could be done in javadocs and referenced here as well.

CHANGES.txt I think we should organize so it looks more like changes entry for flexible indexing or other similar big changes, and there is a coherent summary of what happened.

---

Migrated from LUCENE-7076 by Robert Muir (@rmuir), updated Mar 09 2016
Attachments: LUCENE-7076.patch

[asfimport]

Robert Muir (@rmuir) (migrated from JIRA)

Here's what i could hack up tonight:

• Adds "introduction to points" to org.apache.lucene.index.PointValues
• Link PointValues via @see to most major point classes.
• Fix MIGRATE.txt to be correct and point to "introduction".

It is not perfect but also not bloated, has a simple example, etc. We should still organize CHANGES.txt and maybe add additional verbage.

[asfimport]

Michael McCandless (@mikemccand) (migrated from JIRA)

+1, thanks @rmuir, this looks great! I like the powerful docRoot javascript magic.

[asfimport]

ASF subversion and git services (migrated from JIRA)

Commit 5bb072d in lucene-solr's branch refs/heads/master from @rmuir
https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=5bb072d

LUCENE-7076: Improve MIGRATE.txt/Point javadocs

[asfimport]

ASF subversion and git services (migrated from JIRA)

Commit b97e170 in lucene-solr's branch refs/heads/branch_6x from @rmuir
https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=b97e170

LUCENE-7076: Improve MIGRATE.txt/Point javadocs

[asfimport]

ASF subversion and git services (migrated from JIRA)

Commit d96be77 in lucene-solr's branch refs/heads/branch_6_0 from @rmuir
https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=d96be77

LUCENE-7076: Improve MIGRATE.txt/Point javadocs

[asfimport]

Robert Muir (@rmuir) (migrated from JIRA)

Also any @deprecated warnings need to be clear and point to the best place.

For example LegacyNumericRangeQuery leads you instead to PointRangeQuery, but that is not the place to send the user.

[asfimport]

ASF subversion and git services (migrated from JIRA)

Commit a7ff1c8 in lucene-solr's branch refs/heads/master from @rmuir
https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=a7ff1c8

LUCENE-7076: improve deprecation message for LegacyNumericRangeQuery

[asfimport]

ASF subversion and git services (migrated from JIRA)

Commit 4e911f2 in lucene-solr's branch refs/heads/branch_6x from @rmuir
https://git-wip-us.apache.org/repos/asf?p=lucene-solr.git;h=4e911f2

LUCENE-7076: improve deprecation message for LegacyNumericRangeQuery