apache / lucene

Apache Lucene open-source search software
https://lucene.apache.org/
Apache License 2.0
2.62k stars 1.02k forks source link

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

Open asfimport opened 8 years ago

asfimport commented 8 years ago

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 commented 8 years ago

Robert Muir (@rmuir) (migrated from JIRA)

Here's what i could hack up tonight:

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 commented 8 years ago

Michael McCandless (@mikemccand) (migrated from JIRA)

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

asfimport commented 8 years ago

ASF subversion and git services (migrated from JIRA)

Commit 5bb072d4b91b1324cae4ec08a6f24b63078c37af 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 commented 8 years ago

ASF subversion and git services (migrated from JIRA)

Commit b97e17096e770a4a7c4edc0a353755673ef359ad 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 commented 8 years ago

ASF subversion and git services (migrated from JIRA)

Commit d96be77b23be5f2e69ee2bb91e157ec0a4f07af3 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 commented 8 years ago

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 commented 8 years ago

ASF subversion and git services (migrated from JIRA)

Commit a7ff1c8d3e3ca42f7e7f8696bf1f6048b3bfa2ba 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 commented 8 years ago

ASF subversion and git services (migrated from JIRA)

Commit 4e911f2d3a029ae30dad9ea5ffb42530398adcbc 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