elasticsearch/docs/reference/migration/migrate_8_4.asciidoc
James Rodewig e00b354c26
[DOCS] Remove breaking change tags (#98144)
With https://github.com/elastic/stack-docs/pull/2495 merged, we no longer reuse breaking changes in the Stack Install/Upgrade guide.

This removes the related `notable-breaking-changes[]` tags from the 8.9+ docs and updates the RN generator template.

## Out of scope
With the removal of these tags, we may no longer need the `notable` property for changelog entries and can likely simplify the logic for the [BreakingChangesGenerator](https://github.com/elastic/elasticsearch/blob/main/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/release/BreakingChangesGenerator.java). Updating those files is outside the scope of this PR. I've opened https://github.com/elastic/elasticsearch/issues/98145 to track that work.
2023-08-03 15:23:47 -04:00

46 lines
1.2 KiB
Text

[[migrating-8.4]]
== Migrating to 8.4
++++
<titleabbrev>8.4</titleabbrev>
++++
This section discusses the changes that you need to be aware of when migrating
your application to {es} 8.4.
See also <<release-highlights>> and <<es-release-notes>>.
[discrete]
[[breaking-changes-8.4]]
=== Breaking changes
There are no breaking changes in {es} 8.4.
[discrete]
[[deprecated-8.4]]
=== Deprecations
The following functionality has been deprecated in {es} 8.4
and will be removed in a future version.
While this won't have an immediate impact on your applications,
we strongly encourage you to take the described steps to update your code
after upgrading to 8.4.
To find out if you are using any deprecated functionality,
enable <<deprecation-logging, deprecation logging>>.
[discrete]
[[deprecations_84_rest_api]]
==== REST API deprecations
[[deprecate_knn_search_endpoint]]
.Deprecate the `_knn_search` endpoint
[%collapsible]
====
*Details* +
-| The kNN search API is deprecated in favor of the new 'knn' option inside the search API. The 'knn' option is now the recommended way of running ANN search.
*Impact* +
Users should switch from `_knn_search` to the search `knn` option.
====