changed H1s per SEO suggestions, added frontmatter where necessary

ketkee-aryamane · ketkee-aryamane · commit 5a6df1b0d6f6 · 2025-09-17T18:09:22.000+02:00
diff --git a/docs/reference/getting-started.md b/docs/reference/getting-started.md
@@ -1,9 +1,10 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/getting-started-java.html
+navigation_title: Getting started
 ---
 
-# Getting started
+# Getting started with the {{es}} Java client
 
 This page guides you through the installation process of the Java client, shows you how to instantiate the client, and how to perform basic Elasticsearch operations with it.
 
diff --git a/docs/reference/transport/rest-client/config/basic_authentication.md b/docs/reference/transport/rest-client/config/basic_authentication.md
@@ -1,9 +1,10 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/_basic_authentication.html
+navigation_title: Basic authentication
 ---
 
-# Basic authentication [_basic_authentication]
+# Basic authentication setup for {{es}} Java REST client [_basic_authentication]
 
 :::{include} /reference/_snippets/legacy-rest-client.md
 :::
diff --git a/docs/reference/transport/rest-client/config/index.md b/docs/reference/transport/rest-client/config/index.md
@@ -1,9 +1,10 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/java-rest-low-config.html
+navigation_title: Common configuration
 ---
 
-# Common configuration [java-rest-low-config]
+# {{es}} Java REST client configuration [java-rest-low-config]
 
 :::{include} /reference/_snippets/legacy-rest-client.md
 :::
diff --git a/docs/reference/transport/rest-client/sniffer/javadoc.md b/docs/reference/transport/rest-client/sniffer/javadoc.md
@@ -1,9 +1,10 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/java-rest-sniffer-javadoc.html
+navigation_title: Javadoc
 ---
 
-# Javadoc [java-rest-sniffer-javadoc]
+# Javadoc for the {{es}} Java REST client sniffer [java-rest-sniffer-javadoc]
 
 :::{include} /reference/_snippets/legacy-rest-client.md
 :::
diff --git a/docs/reference/transport/rest-client/sniffer/maven_repository.md b/docs/reference/transport/rest-client/sniffer/maven_repository.md
@@ -1,9 +1,10 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/_maven_repository.html
+navigation_title: Maven Repository
 ---
 
-# Maven Repository [_maven_repository]
+# Maven repository for {{es}} Java REST client sniffer [_maven_repository]
 
 :::{include} /reference/_snippets/legacy-rest-client.md
 :::
diff --git a/docs/reference/transport/rest-client/sniffer/usage.md b/docs/reference/transport/rest-client/sniffer/usage.md
@@ -1,9 +1,10 @@
 ---
 mapped_pages:
-  - https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/_usage.html
+  - https://www.elastic.co/docs/reference/elasticsearch/clients/java/transport/rest-client/usage.html
+navigation_title: Usage
 ---
 
-# Usage [_usage]
+# Getting started with the {{es}} Java REST client [_usage]
 
 :::{include} /reference/_snippets/legacy-rest-client.md
 :::
diff --git a/docs/reference/transport/rest-client/usage/index.md b/docs/reference/transport/rest-client/usage/index.md
@@ -1,9 +1,10 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/java-rest-low-usage.html
+navigation_title: Getting started
 ---
 
-# Getting started [java-rest-low-usage]
+# Getting started with the {{es}} Java REST client [java-rest-low-usage]
 
 :::{include} /reference/_snippets/legacy-rest-client.md
 :::
diff --git a/docs/reference/transport/rest-client/usage/initialization.md b/docs/reference/transport/rest-client/usage/initialization.md
@@ -1,9 +1,10 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/java-rest-low-usage-initialization.html
+navigation_title: Initialization
 ---
 
-# Initialization [java-rest-low-usage-initialization]
+# Initializing the {{es}} Java REST client [java-rest-low-usage-initialization]
 
 :::{include} /reference/_snippets/legacy-rest-client.md
 :::
diff --git a/docs/reference/transport/rest-client/usage/javadoc.md b/docs/reference/transport/rest-client/usage/javadoc.md
@@ -1,9 +1,10 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/java-rest-low-javadoc.html
+navigation_title: Javadoc
 ---
 
-# Javadoc [java-rest-low-javadoc]
+# Javadoc for the {{es}} Java REST client [java-rest-low-javadoc]
 
 :::{include} /reference/_snippets/legacy-rest-client.md
 :::
diff --git a/docs/reference/transport/rest-client/usage/logging.md b/docs/reference/transport/rest-client/usage/logging.md
@@ -1,9 +1,10 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/java-rest-low-usage-logging.html
+navigation_title: Logging
 ---
 
-# Logging [java-rest-low-usage-logging]
+# Logging in the {{es}} Java REST client [java-rest-low-usage-logging]
 
 :::{include} /reference/_snippets/legacy-rest-client.md
 :::
diff --git a/docs/reference/transport/rest-client/usage/maven.md b/docs/reference/transport/rest-client/usage/maven.md
@@ -1,9 +1,10 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/java-rest-low-usage-maven.html
+navigation_title: Maven repository
 ---
 
-# Maven Repository [java-rest-low-usage-maven]
+# Maven repository for {{es}} Java REST client [java-rest-low-usage-maven]
 
 :::{include} /reference/_snippets/legacy-rest-client.md
 :::
diff --git a/docs/reference/transport/rest5-client/config/basic_authentication.md b/docs/reference/transport/rest5-client/config/basic_authentication.md
@@ -1,5 +1,10 @@
+---
+mapped_pages: 
+  - https://www.elastic.co/docs/reference/elasticsearch/clients/java/transport/rest5-client/config/basic_authentication.html
+navigation_title: Basic authentication
+---
 
-# Basic authentication
+# Basic authentication setup for {{es}} Java REST 5 client
 
 To use basic authentication in the REST 5 client, set a default authorization header:
 
diff --git a/docs/reference/transport/rest5-client/config/index.md b/docs/reference/transport/rest5-client/config/index.md
@@ -1,5 +1,10 @@
+---
+mapped_pages: 
+  - https://www.elastic.co/docs/reference/elasticsearch/clients/java/transport/rest5-client/config.html
+navigation_title: Common configuration
+---
 
-# Common configuration
+# {{es}} Java REST 5 client configuration
 
 As explained in [Initialization](../usage/initialization.md), the `RestClientBuilder` supports providing both a `RequestConfigCallback` and an `HttpClientConfigCallback` which allow for any customization that the Apache Async Http Client exposes. Those callbacks make it possible to modify some specific behaviour of the client without overriding every other default configuration that the `Rest5Client` is initialized with. This section describes some common scenarios that require additional configuration for the low-level Java REST Client.
 
diff --git a/docs/reference/transport/rest5-client/usage/index.md b/docs/reference/transport/rest5-client/usage/index.md
@@ -1,5 +1,10 @@
+---
+mapped_pages: 
+  - https://www.elastic.co/docs/reference/elasticsearch/clients/java/transport/rest5-client/usage.html
+navigation_title: Getting started
+---
 
-# Getting started
+# Getting started with the {{es}} Java Rest 5 client
 
 This section describes how to get started with the low-level REST client from getting the artifact to using it in an application.
 
diff --git a/docs/reference/transport/rest5-client/usage/initialization.md b/docs/reference/transport/rest5-client/usage/initialization.md
@@ -1,5 +1,10 @@
+---
+mapped_pages:
+  - https://www.elastic.co/docs/reference/elasticsearch/clients/java/transport/rest5-client/usage/initialization.html
+navigation_title: Initialization
+---
 
-# Initialization
+# Initializing the {{es}} Java REST 5 client 
 
 A `Rest5Client` instance can be built through the corresponding `Rest5ClientBuilder` class, created via `Rest5Client#builder(...)` static method. The only required argument is one or more URLs or `HttpHost` that the client will communicate with as follows:
 
diff --git a/docs/reference/transport/rest5-client/usage/logging.md b/docs/reference/transport/rest5-client/usage/logging.md
@@ -1,4 +1,10 @@
-# Logging
+---
+mapped_pages:
+  - https://www.elastic.co/docs/reference/elasticsearch/clients/java/transport/rest5-client/usage/logging.html
+navigation_title: Logging
+---
+
+# Logging in the {{es}} Java REST 5 client
 
 The Java REST 5 client uses the same logging library that the Apache Async Http Client uses: [Apache Commons Logging](https://commons.apache.org/proper/commons-logging/), which comes with support for a number of popular logging implementations. The java packages to enable logging for is `co.elastic.clients.transport.rest5_client`.
 
