Fix simulate client docs (#2749)

* Fix simulate client docs

* Fix formatting of Markdown code blocks

* Fail on warnings when running `nox -s docs` too

* Fix lint

* Revert "Fix formatting of Markdown code blocks"

This reverts commit 956175d.

Author: pquentin

.readthedocs.yml

@@ -17,3 +17,4 @@ python:
 
 sphinx:
   configuration: docs/sphinx/conf.py
+  fail_on_warning: true

docs/sphinx/api/simulate.rst

@@ -1,4 +1,4 @@
-.. _snapshot-lifecycle-management:
+.. _simulate:
 
 Simulate
 --------

elasticsearch/client.py

@@ -57,6 +57,7 @@
 )
 from ._sync.client.security import SecurityClient as SecurityClient  # noqa: F401
 from ._sync.client.shutdown import ShutdownClient as ShutdownClient  # noqa: F401
+from ._sync.client.simulate import SimulateClient as SimulateClient  # noqa: F401
 from ._sync.client.slm import SlmClient as SlmClient  # noqa: F401
 from ._sync.client.snapshot import SnapshotClient as SnapshotClient  # noqa: F401
 from ._sync.client.sql import SqlClient as SqlClient  # noqa: F401
@@ -107,6 +108,7 @@
     "SearchableSnapshotsClient",
     "SecurityClient",
     "ShutdownClient",
+    "SimulateClient",
     "SlmClient",
     "SnapshotClient",
     "SqlClient",

noxfile.py

@@ -161,4 +161,6 @@ def lint(session):
 @nox.session()
 def docs(session):
     session.install(".[docs]")
-    session.run("sphinx-build", "docs/sphinx/", "docs/sphinx/_build", "-b", "html")
+    session.run(
+        "sphinx-build", "-W", "docs/sphinx/", "docs/sphinx/_build", "-b", "html"
+    )