[DOCS] Add admon for legacy prefix tree mapping params (#76582) (#77372)

If you specify a deprecated mapping parameter related to prefix trees, a
`geo_shape` field will use prefix tree encoding.

This adds a related admon to the top of the geoshape field docs page. This admon will
help users avoid accidentally switching from the default BKD tree encoding.

Closes #40266.

Author: jrodewig

docs/reference/mapping/types/geo-shape.asciidoc

@@ -12,6 +12,23 @@ contain shapes other than just points.
 You can query documents using this type using
 <<query-dsl-geo-shape-query,geo_shape Query>>.
 
+[IMPORTANT]
+====
+{es} encodes `geo_shape` values as <<geoshape-indexing-approach,BKD trees>> by
+default. To use BKD encoding, do not specify the following
+<<geo-shape-mapping-options,mapping options>>:
+
+* `distance_error_pct`
+* `points_only` 
+* `precision`
+* `strategy`
+* `tree_levels`
+* `tree`
+
+If you specify one or more of these options, the field will use prefix tree
+encoding instead. Prefix tree encoding is deprecated.
+====
+
 [[geo-shape-mapping-options]]
 [discrete]
 ==== Mapping Options