elasticsearch/docs/reference
Craig Taverner 5f7ea792ac
Soft-deprecation of point/geo_point formats (#86835)
* Soft-deprecation of point/geo_point formats

Since GeoJSON and WKT are now common formats for all three types:
  geo_shape, geo_point and point
We decided to soft-deprecate the other point formats by ordering:
* GeoJSON (object with keys `type` and `coordinates`)
* WKT `POINT(x y)`
* Object with keys `lat` and `lon` (or `x` and `y` for point)
* Array [lon,lat]
* String `"lat,lon"` (or `"x,y"` in point)
* String with geohash (only in `geo_point`)

The geohash is last because it is only in one field type.
The string version is second last because it is the most controversial
being the only version to reverse the coordinate order from all other
formats (for geo_point only, since the coordinates are not reversed
in point).

In addition we replaced many examples in both documentation and tests
to prioritize WKT over the plain string format.

Many remaining examples of array format or object with keys still exist
and could be replaced by, for example, GeoJSON, if we feel the need.

* Incorrect quote position
2022-05-17 23:46:43 +02:00
..
aggregations Soft-deprecation of point/geo_point formats (#86835) 2022-05-17 23:46:43 +02:00
analysis Fix some typos in plugins & reference docs (#84667) 2022-03-07 12:29:58 -05:00
autoscaling [DOCS] Remove `testenv` annotations from doc snippet tests (#80023) 2021-11-05 18:38:50 -04:00
cat correct way of getting node heap size (#85045) 2022-05-11 09:59:34 -04:00
ccr [DOCS] Clarify when changes are replicated in CCR (#83863) 2022-02-11 16:07:38 -05:00
cluster Add master_timeout support to voting config exclusions APIs (#86670) 2022-05-11 13:56:50 +01:00
commands Fix some typos in plugins & reference docs (#84667) 2022-03-07 12:29:58 -05:00
data-management [DOC] auto migrate only for default template (#82043) 2022-05-10 11:35:19 -04:00
data-streams [DOCS] Fix ordered list formatting in data stream docs (#81667) 2021-12-13 12:53:48 -05:00
docs [Docs] Document apiKey usage in remote reindex (#85209) 2022-05-10 14:31:42 -04:00
eql [DOCS] Fix `ignore_unavailable` parameter definition (#84071) 2022-02-17 08:24:06 -05:00
features/apis
fleet Fix some typos in plugins & reference docs (#84667) 2022-03-07 12:29:58 -05:00
graph [DOCS] Fix typos (#83895) 2022-02-15 12:42:17 -05:00
health How-to docs for increasing the total number of shards per node (#86214) 2022-05-10 09:13:27 +01:00
high-availability [DOCS] Overhaul snapshot and restore docs (#79081) 2021-11-15 12:45:07 -05:00
how-to correct way of getting node heap size (#85045) 2022-05-11 09:59:34 -04:00
ilm [DOCS] Remove unnecessary link. (#86205) 2022-04-27 15:44:43 -07:00
images SQL: Update DbVisualizer connection steps (#85167) 2022-03-31 16:48:24 +02:00
index-modules Docs: Fixing formatting on slow log page (#84509) 2022-03-01 14:05:34 -05:00
indices Rectified the "Add lifecycle policy" hyperlink. (#86717) (#86735) 2022-05-12 10:22:40 -04:00
ingest [DOC] Air gapped environments and GEOIP (#85637) 2022-05-10 16:34:28 -04:00
licensing [DOCS] Remove `testenv` annotations from doc snippet tests (#80023) 2021-11-05 18:38:50 -04:00
mapping Soft-deprecation of point/geo_point formats (#86835) 2022-05-17 23:46:43 +02:00
migration [Docs] Fix url for feature migration APIs (#86330) 2022-05-03 10:05:02 +10:00
ml [DOCS] Updates example output for start trained model deployment API (#86824) 2022-05-17 07:27:44 -07:00
modules Reduce resource needs of join validation (#85380) 2022-04-26 12:15:54 +01:00
monitoring Update setting deprecation messages to remove major release references (#83528) 2022-02-04 13:53:20 -05:00
query-dsl Soft-deprecation of point/geo_point formats (#86835) 2022-05-17 23:46:43 +02:00
release-notes Update8.2.0 BC4 docs (#86084) (#86213) 2022-04-27 14:09:40 +02:00
repositories-metering-api [DOCS] Remove `testenv` annotations from doc snippet tests (#80023) 2021-11-05 18:38:50 -04:00
rest-api [Transform] Support `range` aggregation in transform (#86501) 2022-05-16 15:21:00 +02:00
rollup [DOCS] Remove `testenv` annotations from doc snippet tests (#80023) 2021-11-05 18:38:50 -04:00
scripting [DOCS] Add documentation for Painless field API (#83388) 2022-02-03 15:15:38 -05:00
search Soft-deprecation of point/geo_point formats (#86835) 2022-05-17 23:46:43 +02:00
searchable-snapshots Add note that searchable snapshots indices cannot be snapshotted into source-only repositories (#86208) 2022-05-06 11:33:50 +02:00
settings [DOCS] Document when security auto configuration is skipped (#86575) 2022-05-17 08:27:48 -04:00
setup [doc] update deprecation logging (#83723) 2022-05-17 16:17:54 +02:00
shutdown/apis [doc] Explicitly mention about node shutdown remove for cluster shrink (#86173) 2022-05-09 10:24:54 +02:00
slm/apis [DOCS] Remove soft limit for snapshot repositories (#80745) 2021-11-16 12:24:18 -05:00
snapshot-restore Small additions to the register-repo docs (#86122) 2022-05-09 07:37:20 +01:00
sql SQ: Allow partial results in SQL queries (#85897) 2022-04-21 18:12:50 +02:00
tab-widgets How-to docs for increasing the total number of shards per node (#86214) 2022-05-10 09:13:27 +01:00
text-structure/apis [DOCS] Remove `testenv` annotations from doc snippet tests (#80023) 2021-11-05 18:38:50 -04:00
transform [DOCS] Edits transform secondary auth header details (#86815) 2022-05-17 07:25:23 -07:00
troubleshooting/data How-to docs for increasing the total number of shards per node (#86214) 2022-05-10 09:13:27 +01:00
upgrade Permit removal of archived index settings (#86107) 2022-04-26 08:27:16 +01:00
vectors [DOCS] Remove `testenv` annotations from doc snippet tests (#80023) 2021-11-05 18:38:50 -04:00
aggregations.asciidoc
alias.asciidoc
analysis.asciidoc Update Lucene analysis base url (#84094) 2022-02-17 12:44:12 +01:00
api-conventions.asciidoc [DOCS] System indices no longer accessible 8.0 (#84377) (#84438) 2022-02-28 12:02:54 -05:00
cat.asciidoc
cluster.asciidoc How-to docs for increasing the total number of shards per node (#86214) 2022-05-10 09:13:27 +01:00
data-management.asciidoc reorder and merge data management and ILM doc pages (#84679) 2022-03-07 18:33:28 -05:00
data-rollup-transform.asciidoc
datatiers.asciidoc [DOCS] Fix duplicate anchor (#85424) 2022-03-28 15:16:08 -07:00
dependencies-versions.asciidoc
docs.asciidoc
getting-started.asciidoc [DOCS] Update ES quick start for security ON by default (#80735) 2021-11-17 17:48:07 -05:00
gs-index.asciidoc
high-availability.asciidoc [DOCS] Overhaul snapshot and restore docs (#79081) 2021-11-15 12:45:07 -05:00
how-to.asciidoc How-to docs for increasing the total number of shards per node (#86214) 2022-05-10 09:13:27 +01:00
index-extra-title-page.html
index-modules.asciidoc shards allocation health indicator services (#83513) 2022-03-07 09:31:33 +01:00
index.asciidoc How-to docs for increasing the total number of shards per node (#86214) 2022-05-10 09:13:27 +01:00
index.x.asciidoc
indices.asciidoc Remove endpoint for freezing indices (#78918) 2021-10-26 06:37:56 -05:00
ingest.asciidoc [DOCS] Update screenshots for ingest pipeline docs (#83845) 2022-02-23 10:50:02 -05:00
intro.asciidoc [DOCS] Update ES intro for stretched clusters (#77651) 2021-09-13 16:50:08 -04:00
links.asciidoc
mapping.asciidoc
query-dsl.asciidoc Allow doc-values only search on geo_point fields (#83395) 2022-02-02 11:56:19 +01:00
redirects.asciidoc [DOCS] Removes infer trained model deployment API (#86497) 2022-05-10 09:56:36 -07:00
release-notes.asciidoc [DOCS] Add docs for v8.2.0 release (#86007) 2022-04-21 10:49:38 +02:00
scripting.asciidoc [DOCS] Add documentation for Painless field API (#83388) 2022-02-03 15:15:38 -05:00
search.asciidoc [DOCS] Add high-level guide for kNN search (#80857) 2021-11-30 14:17:39 -05:00
setup.asciidoc [DOCS] Overhaul snapshot and restore docs (#79081) 2021-11-15 12:45:07 -05:00
troubleshooting.asciidoc How-to docs for increasing the total number of shards per node (#86214) 2022-05-10 09:13:27 +01:00
upgrade.asciidoc [DOCS] Fix upgrade docs for 8.x (#84076) 2022-02-23 10:53:18 -05:00