Merge pull request #2681 from lonvia/improve-geocodejson

[nominatim.git] / docs / admin / Migration.md

diff --git a/docs/admin/Migration.md b/docs/admin/Migration.md
index 8458e3d921409fdd1d8a8adbb68c1d120370348c..11ee7f0558c37406599d681334b602524492f363 100644 (file)
--- a/docs/admin/Migration.md
+++ b/docs/admin/Migration.md
@@ -15,7 +15,16 @@ breaking changes. **Please read them before running the migration.**
     If you are migrating from a version <3.6, then you still have to follow
     the manual migration steps up to 3.6.
 
-## 3.7.0 -> master
+## 4.0.0 -> master
+
+### geocodejson output changed
+
+The `type` field of the geocodejson output has changed. It now contains
+the address class of the object instead of the value of the OSM tag. If
+your client has used the `type` field, switch them to read `osm_value`
+instead.
+
+## 3.7.0 -> 4.0.0
 
 ### NOMINATIM_PHRASE_CONFIG removed
 
@@ -29,6 +38,13 @@ the configuration in older versions. If you are updating from Nominatim < 3.7
 and still work with a custom `phrase-settings.php`, you need to manually
 convert it into a json format.
 
+### PHP utils removed
+
+The old PHP utils have now been removed completely. You need to switch to
+the appropriate functions of the nominatim  command line tool. See
+[Introducing `nominatim` command line tool](#introducing-nominatim-command-line-tool)
+below.
+
 ## 3.6.0 -> 3.7.0
 
 ### New format and name of configuration file