elastic · pquentin · Mar 6, 2025 · Mar 3, 2025 · Mar 6, 2025 · Mar 6, 2025
diff --git a/.readthedocs.yml b/.readthedocs.yml
@@ -10,3 +10,7 @@ python:
     - path: .
       extra_requirements:
         - "docs"
+
+sphinx:
+  configuration: docs/sphinx/conf.py
+  fail_on_warning: true
diff --git a/docs/sphinx/api.rst b/docs/sphinx/api.rst
@@ -14,129 +14,28 @@ arguments are required for all
    aliased as ``from_``.
 
 
-Elasticsearch
--------------
 
-.. py:module:: elasticsearch_serverless
-
-.. autoclass:: Elasticsearch
-   :members:
-
-.. py:module:: elasticsearch_serverless.client
-
-Async Search
-------------
-
-.. autoclass:: AsyncSearchClient
-   :members:
-
-Cat
----
-
-.. autoclass:: CatClient
-   :members:
-
-Cluster
--------
-
-.. autoclass:: ClusterClient
-   :members:
-
-Connector
----------
-.. py:module:: elasticsearch.client
-   :noindex:
-
-.. autoclass:: ConnectorClient
-   :members:
-
-Enrich Policies
----------------
-
-.. autoclass:: EnrichClient
-   :members:
-
-Event Query Language (EQL)
---------------------------
-
-.. autoclass:: EqlClient
-   :members:
-
-
-ES|QL
------
-
-.. autoclass:: EqlClient
-   :members:
-
-Graph Explore
--------------
-
-.. autoclass:: GraphClient
-   :members:
-
-Indices
--------
-
-.. autoclass:: IndicesClient
-   :members:
-
-Inference
----------
-
-.. autoclass:: InferenceClient
-   :members:
-
-Ingest Pipelines
-----------------
-
-.. autoclass:: IngestClient
-   :members:
-
-License
--------
-
-.. autoclass:: LicenseClient
-   :members:
-
-Logstash
---------
-
-.. autoclass:: LogstashClient
-   :members:
-
-Machine Learning (ML)
----------------------
-
-.. autoclass:: MlClient
-   :members:
-
-Monitoring
-----------
-
-.. autoclass:: MonitoringClient
-   :members:
-
-Security
---------
-
-.. autoclass:: SecurityClient
-   :members:
-
-SQL
----
-
-.. autoclass:: SqlClient
-   :members:
-
-Tasks
------
-
-.. autoclass:: TasksClient
-   :members:
-
-Transforms
-----------
-
-.. autoclass:: TransformClient
-   :members:
+.. toctree::
+   :maxdepth: 1
+
+   api/elasticsearch
+   api/async-search
+   api/cat
+   api/cluster
+   api/connector
+   api/enrich-policies
+   api/eql
+   api/esql
+   api/indices
+   api/inference
+   api/ingest-pipelines
+   api/license
+   api/logstash
+   api/ml
+   api/query-rules
+   api/search-application
+   api/security
+   api/sql
+   api/synonyms
+   api/tasks
+   api/transforms
diff --git a/docs/sphinx/api/async-search.rst b/docs/sphinx/api/async-search.rst
@@ -0,0 +1,10 @@
+.. _async_search:
+
+Async Search
+------------
+
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: AsyncSearchClient 
+   :members:
diff --git a/docs/sphinx/api/cat.rst b/docs/sphinx/api/cat.rst
@@ -0,0 +1,9 @@
+.. _cat:
+
+Cat
+---
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: CatClient
+   :members:
diff --git a/docs/sphinx/api/cluster.rst b/docs/sphinx/api/cluster.rst
@@ -0,0 +1,9 @@
+.. _cluster:
+
+Cluster
+-------
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: ClusterClient
+   :members:
diff --git a/docs/sphinx/api/connector.rst b/docs/sphinx/api/connector.rst
@@ -0,0 +1,9 @@
+.. _connector:
+
+Connector
+---------
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: ConnectorClient
+   :members:
diff --git a/docs/sphinx/api/elasticsearch.rst b/docs/sphinx/api/elasticsearch.rst
@@ -0,0 +1,9 @@
+.. _elasticsearch:
+
+Elasticsearch
+-------------
+
+.. py:module:: elasticsearch_serverless
+
+.. autoclass:: Elasticsearch
+   :members:
diff --git a/docs/sphinx/api/enrich-policies.rst b/docs/sphinx/api/enrich-policies.rst
@@ -0,0 +1,9 @@
+.. _enrich-policies:
+
+Enrich Policies
+---------------
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: EnrichClient
+   :members:
diff --git a/docs/sphinx/api/eql.rst b/docs/sphinx/api/eql.rst
@@ -0,0 +1,9 @@
+.. _eql:
+
+Event Query Language (EQL)
+--------------------------
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: EqlClient
+   :members:
diff --git a/docs/sphinx/api/esql.rst b/docs/sphinx/api/esql.rst
@@ -0,0 +1,9 @@
+.. _esql:
+
+ES|QL
+-----
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: EsqlClient
+   :members:
diff --git a/docs/sphinx/api/indices.rst b/docs/sphinx/api/indices.rst
@@ -0,0 +1,9 @@
+.. _indices:
+
+Indices
+-------
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: IndicesClient
+   :members:
diff --git a/docs/sphinx/api/inference.rst b/docs/sphinx/api/inference.rst
@@ -0,0 +1,9 @@
+.. _inference:
+
+Inference
+---------
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: InferenceClient
+   :members:
diff --git a/docs/sphinx/api/ingest-pipelines.rst b/docs/sphinx/api/ingest-pipelines.rst
@@ -0,0 +1,9 @@
+.. _ingest-pipelines:
+
+Ingest Pipelines
+----------------
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: IngestClient
+   :members:
diff --git a/docs/sphinx/api/license.rst b/docs/sphinx/api/license.rst
@@ -0,0 +1,9 @@
+.. _license:
+
+License
+-------
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: LicenseClient
+   :members:
diff --git a/docs/sphinx/api/logstash.rst b/docs/sphinx/api/logstash.rst
@@ -0,0 +1,9 @@
+.. _logstash:
+
+Logstash
+--------
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: LogstashClient
+   :members:
diff --git a/docs/sphinx/api/ml.rst b/docs/sphinx/api/ml.rst
@@ -0,0 +1,9 @@
+.. _ml:
+
+Machine Learning (ML)
+---------------------
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: MlClient
+   :members:
diff --git a/docs/sphinx/api/query-rules.rst b/docs/sphinx/api/query-rules.rst
@@ -0,0 +1,9 @@
+.. _query-rules:
+
+Query rules
+-----------
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: QueryRulesClient
+   :members:
diff --git a/docs/sphinx/api/search-application.rst b/docs/sphinx/api/search-application.rst
@@ -0,0 +1,9 @@
+.. _search-application:
+
+Search Applications
+-------------------
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: SearchApplicationClient
+   :members:
diff --git a/docs/sphinx/api/security.rst b/docs/sphinx/api/security.rst
@@ -0,0 +1,9 @@
+.. _security:
+
+Security
+--------
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: SecurityClient
+   :members:
diff --git a/docs/sphinx/api/sql.rst b/docs/sphinx/api/sql.rst
@@ -0,0 +1,9 @@
+.. _sql:
+
+SQL
+---
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: SqlClient
+   :members:
diff --git a/docs/sphinx/api/synonyms.rst b/docs/sphinx/api/synonyms.rst
@@ -0,0 +1,9 @@
+.. _synonyms:
+
+Synonyms
+--------
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: SynonymsClient
+   :members:
diff --git a/docs/sphinx/api/tasks.rst b/docs/sphinx/api/tasks.rst
@@ -0,0 +1,9 @@
+.. _tasks:
+
+Tasks
+-----
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: TasksClient
+   :members:
diff --git a/docs/sphinx/api/transforms.rst b/docs/sphinx/api/transforms.rst
@@ -0,0 +1,9 @@
+.. _transforms:
+
+Transforms
+----------
+.. py:module:: elasticsearch_serverless.client
+   :noindex:
+
+.. autoclass:: TransformClient
+   :members: