[Docs] Add redirects, make small fixes

docs/redirects.yml

@@ -1,4 +1,48 @@
 redirects:
   'reference/_others.md': 'reference/transport/rest-client/config/others.md'
   'reference/installation.md': 'reference/setup/installation.md'
-  'reference/_basic_authentication.md': 'reference/transport/rest-client/config/basic_authentication.md'
+  'reference/_basic_authentication.md': 'reference/transport/rest-client/config/basic_authentication.md'
+  'reference/api-conventions.md': 'reference/api-conventions/index.md'
+  'reference/blocking-async.md': 'reference/api-conventions/blocking-async.md'
+  'reference/building-objects.md': 'reference/api-conventions/building-objects.md'
+  'reference/exception-conventions.md': 'reference/api-conventions/exception-conventions.md'
+  'reference/lists-maps.md': 'reference/api-conventions/lists-maps.md'
+  'reference/loading-json.md': 'reference/api-conventions/loading-json.md'
+  'reference/method-naming.md': 'reference/api-conventions/method-naming.md'
+  'reference/object-lifecycles.md': 'reference/api-conventions/object-lifecycles.md'
+  'reference/package-structure.md': 'reference/api-conventions/package-structure.md'
+  'reference/variant-types.md': 'reference/api-conventions/variant-types.md'
+  'reference/_license.md': 'reference/license.md'
+  'reference/connecting.md': 'reference/setup/connecting.md'
+  'reference/opentelemetry.md': 'reference/setup/opentelemetry.md'
+  'reference/_encrypted_communication.md': 'reference/transport/rest-client/config/encrypted_communication.md'
+  'reference/_node_selector.md': 'reference/transport/rest-client/config/node_selector.md'
+  'reference/_number_of_threads.md': 'reference/transport/rest-client/config/number_of_threads.md'
+  'reference/_other_authentication_methods.md': 'reference/transport/rest-client/config/other_authentication_methods.md'
+  'reference/_timeouts.md': 'reference/transport/rest-client/config/timeouts.md'
+  'reference/java-low-level-rest-client.md': 'reference/transport/rest-client/index.md'
+  'reference/sniffer.md': 'reference/transport/rest-client/sniffer/index.md'
+  'reference/java-rest-sniffer-javadoc.md': 'reference/transport/rest-client/sniffer/javadoc.md'
+  'reference/_maven_repository.md': 'reference/transport/rest-client/sniffer/maven_repository.md'
+  'reference/_usage.md': 'reference/transport/rest-client/sniffer/usage.md'
+  'reference/java-rest-low-usage-dependencies.md': 'reference/transport/rest-client/usage/dependencies.md'
+  'reference/java-rest-low-javadoc.md': 'reference/transport/rest-client/usage/javadoc.md'
+  'reference/java-rest-low-usage.md': 'reference/transport/rest-client/usage/index.md'
+  'reference/java-rest-low-usage-initialization.md': 'reference/transport/rest-client/usage/initialization.md'
+  'reference/java-rest-low-usage-logging.md': 'reference/transport/rest-client/usage/logging.md'
+  'reference/java-rest-low-usage-maven.md': 'reference/transport/rest-client/usage/maven.md'
+  'reference/java-rest-low-usage-requests.md': 'reference/transport/rest-client/usage/requests.md'
+  'reference/java-rest-low-usage-responses.md': 'reference/transport/rest-client/usage/responses.md'
+  'reference/java-rest-low-usage-shading.md': 'reference/transport/rest-client/usage/shading.md'
+  'reference/aggregations.md': 'reference/usage/aggregations.md'
+  'reference/esql.md': 'reference/usage/esql.md'
+  'reference/using-java-api-client.md': 'reference/usage/index.md'
+  'reference/indexing-bulk.md': 'reference/usage/indexing-bulk.md'
+  'reference/indexing.md': 'reference/usage/indexing.md'
+  'reference/reading.md': 'reference/usage/reading.md'
+  'reference/searching.md': 'reference/usage/searching.md'
+  'reference/java-rest-low-config.md': 'reference/transport/rest-client/config/index.md'
+  'reference/migrate-hlrc.md': 'reference/index.md'
+  'reference/setup.md': 'reference/setup/index.md'
+
+

docs/reference/breaking-changes-policy.md

@@ -33,3 +33,6 @@ Major releases (e.g. 7.x → 8.x) can include larger refactorings of the API spe
 
 All Elasticsearch APIs have stability indicators, which imply potential changes. If an API is `stable` only additional non-breaking changes are added. In case of `experimental` APIs, breaking changes can be introduced any time, which means that these changes, will also be reflected in the Java API Client.
 
+## Breaking changes by release
+
+For more information, refer to the [](../release-notes/index.md).

docs/reference/release-highlights.md

@@ -7,8 +7,8 @@ mapped_pages:
 
 These are the important new features and changes in minor releases. Every release also updates the Java API Client to the latest [API specification](https://github.com/elastic/elasticsearch-specification). This includes new APIs and bug fixes in the specification of existing APIs.
 
-For a list of detailed changes, including bug fixes, please see the [GitHub project realease notes](https://github.com/elastic/elasticsearch-java/releases).
+For a list of detailed changes, including bug fixes, please see the [GitHub project release notes](https://github.com/elastic/elasticsearch-java/releases).
 
-### 9.0.0 [release-highlights-900]
+## 9.0.0 [release-highlights-900]
 
-[Release Notes](/release-notes/9-0-0.md)
+[Release notes](/release-notes/9-0-0.md)

docs/release-notes/9-0-0.md

@@ -3,9 +3,9 @@ navigation_title: "9.0.0"
 ---
 # Elasticsearch Java Client 9.0.0 [elasticsearch-java-client-900]
 
-Discover what changed in the 9.0.0 version of the java client. 
+Discover what changed in the 9.0.0 version of the Java client. 
 
-### Breaking Changes [elasticsearch-java-client-900-breaking-changes]
+### Breaking changes [elasticsearch-java-client-900-breaking-changes]
 
 ::::{dropdown} Server accurate aggregation number values  
 In previous versions of the client, when the server returned number that was both always present and could be `null` (for example Aggregation results), the client would default to `0` and deserialize the number into a primitive data type instead of an Object. This design choice was changed in this version, changing the fields type to support `null` and be coherent with the server response.

docs/release-notes/index.md

@@ -9,3 +9,6 @@ mapped_pages:
 Review the changes, fixes, and more in each version of Elasticsearch Java Client.
 
 To check for security updates, go to [Security announcements for the Elastic stack](https://discuss.elastic.co/c/announcements/security-announcements/31).
+
+## 9.0.0
+[Release notes](../release-notes/9-0-0.md)