[lucene] 02/02: Improve MIGRATE.md around analyzers artifacts. (#488)

[rm...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

rmuir pushed a commit to branch branch_9_0
in repository https://gitbox.apache.org/repos/asf/lucene.git

commit 5216297029c90d7b263764983e8f4b9d73489c3a
Author: Robert Muir <rm...@apache.org>
AuthorDate: Mon Nov 29 17:04:15 2021 -0500

    Improve MIGRATE.md around analyzers artifacts. (#488)
    
    * Improve MIGRATE.md around analyzers artifacts.
    
    Move this to the very top of MIGRATE, the user needs to first be able to
    pull in the artifacts, before doing anything else like trying to
    compile, deal with renamed classes, etc.
    
    Add a table of each package that got moved, with explicit old and new
    names. Hopefully it helps search engines and users.
    
    Link to MIGRATE.md explicitly from README.md
---
 README.md         |  1 +
 lucene/MIGRATE.md | 23 ++++++++++++++++++-----
 2 files changed, 19 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index f6c3619..260bcbc 100644
--- a/README.md
+++ b/README.md
@@ -33,6 +33,7 @@ comprehensive documentation, visit:
 - Nightly: <https://ci-builds.apache.org/job/Lucene/job/Lucene-Artifacts-main/javadoc/>
 - Build System Documentation: [help/](./help/)
 - Developer Documentation: [dev-docs/](./dev-docs/)
+- Migration Guide: [lucene/MIGRATE.md](./lucene/MIGRATE.md)
 
 ## Building with Gradle
 
diff --git a/lucene/MIGRATE.md b/lucene/MIGRATE.md
index f2ec458..005791c 100644
--- a/lucene/MIGRATE.md
+++ b/lucene/MIGRATE.md
@@ -17,6 +17,24 @@
 
 # Apache Lucene Migration Guide
 
+## Rename of binary artifacts from '**-analyzers-**' to '**-analysis-**' (LUCENE-9562)
+
+All binary analysis packages (and corresponding Maven artifacts) have been renamed and are
+now consistent with repository module 'analysis'. You will need to adjust build dependencies
+to the new coordinates:
+
+|         Old Artifact Coordinates            |        New Artifact Coordinates            |
+|---------------------------------------------|--------------------------------------------|
+|org.apache.lucene:lucene-analyzers-common    |org.apache.lucene:lucene-analysis-common    |
+|org.apache.lucene:lucene-analyzers-icu       |org.apache.lucene:lucene-analysis-icu       |
+|org.apache.lucene:lucene-analyzers-kuromoji  |org.apache.lucene:lucene-analysis-kuromoji  |
+|org.apache.lucene:lucene-analyzers-morfologik|org.apache.lucene:lucene-analysis-morfologik|
+|org.apache.lucene:lucene-analyzers-nori      |org.apache.lucene:lucene-analysis-nori      |
+|org.apache.lucene:lucene-analyzers-opennlp   |org.apache.lucene:lucene-analysis-opennlp   |
+|org.apache.lucene:lucene-analyzers-phonetic  |org.apache.lucene:lucene-analysis-phonetic  |
+|org.apache.lucene:lucene-analyzers-smartcn   |org.apache.lucene:lucene-analysis-smartcn   |
+|org.apache.lucene:lucene-analyzers-stempel   |org.apache.lucene:lucene-analysis-stempel   |
+
 ## LucenePackage class removed (LUCENE-10260)
 
 LucenePackage class has been removed. The implementation string can be
@@ -75,11 +93,6 @@ the default stop tags returned by `JapaneseAnalyzer.getDefaultStopTags()` (i.e.
 o.a.l.collation.ICUCollationAnalyzer is renamed to o.a.l.a.icu.ICUCollationKeyAnalyzer.
 Also, its dependant classes are renamed in the same way.
 
-## Rename of binary artifacts from '**-analyzers-**' to '**-analysis-**' (LUCENE-9562)
-
-All binary analysis packages (and corresponding Maven artifacts) have been renamed and are
-now consistent with repository module 'analysis'. 
-
 ## Base and concrete analysis factories are moved / package renamed (LUCENE-9317)
 
 1. Base analysis factories are moved to `lucene-core`, also their package names are renamed.