From 4182c6fd5a1fc59e215f1b23855a960ae41de9d4 Mon Sep 17 00:00:00 2001
From: Khabib <136262760+Khabib73@users.noreply.github.com>
Date: Mon, 7 Sep 2026 00:34:28 +0300
Subject: [PATCH 1/2] fix docs

---
 docs/conf.py    |  7 -------
 docs/driver.rst | 12 ++++++------
 2 files changed, 6 insertions(+), 13 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index a13337e5e..fb19c9773 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -83,13 +83,6 @@
 #
 html_theme = 'sphinx_rtd_theme'
 
-html_theme_options = {
-    'fixed_sidebar': True,
-    'page_width': '1140px',
-    'show_related': True,
-    'show_powered_by': False
-}
-
 html_logo = '_static/logo.svg'
 html_favicon = '_static/logo.svg'
 html_baseurl = 'https://ydb-platform.github.io/ydb-python-sdk/'
diff --git a/docs/driver.rst b/docs/driver.rst
index c49054b6c..d58762400 100644
--- a/docs/driver.rst
+++ b/docs/driver.rst
@@ -166,7 +166,7 @@ AnonymousCredentials
 ^^^^^^^^^^^^^^^^^^^^
 
 No authentication. Use for local or unauthenticated deployments
-(`full example <https://github.com/ydb-platform/ydb-python-sdk/tree/main/examples/anonymous-credentials>`_):
+(`full example <https://github.com/ydb-platform/ydb-python-sdk/tree/main/examples/anonymous-credentials>`__):
 
 .. code-block:: python
 
@@ -176,7 +176,7 @@ AccessTokenCredentials
 ^^^^^^^^^^^^^^^^^^^^^^
 
 Pass a static IAM token or API key directly
-(`full example <https://github.com/ydb-platform/ydb-python-sdk/tree/main/examples/access-token-credentials>`_):
+(`full example <https://github.com/ydb-platform/ydb-python-sdk/tree/main/examples/access-token-credentials>`__):
 
 .. code-block:: python
 
@@ -185,7 +185,7 @@ Pass a static IAM token or API key directly
 StaticCredentials (username/password)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-(`full example <https://github.com/ydb-platform/ydb-python-sdk/tree/main/examples/static-credentials>`_)
+(`full example <https://github.com/ydb-platform/ydb-python-sdk/tree/main/examples/static-credentials>`__)
 
 .. code-block:: python
 
@@ -196,7 +196,7 @@ Service Account Credentials
 
 Authenticate as a Yandex Cloud service account using a key file. Requires the ``ydb[yc]``
 extra (``pip install ydb[yc]``)
-(`full example <https://github.com/ydb-platform/ydb-python-sdk/tree/main/examples/service-account-credentials>`_):
+(`full example <https://github.com/ydb-platform/ydb-python-sdk/tree/main/examples/service-account-credentials>`__):
 
 .. code-block:: python
 
@@ -212,7 +212,7 @@ Metadata Credentials
 
 Picks up credentials from the instance metadata service when running inside Yandex Cloud
 (Compute VM, Cloud Functions, etc.). Requires ``ydb[yc]``
-(`full example <https://github.com/ydb-platform/ydb-python-sdk/tree/main/examples/metadata-credentials>`_):
+(`full example <https://github.com/ydb-platform/ydb-python-sdk/tree/main/examples/metadata-credentials>`__):
 
 .. code-block:: python
 
@@ -225,7 +225,7 @@ OAuth 2.0 Token Exchange
 
 For federated identity scenarios. Exchanges a subject token (e.g. a signed JWT) for a
 YDB access token via an OAuth 2.0 token exchange endpoint
-(`full example <https://github.com/ydb-platform/ydb-python-sdk/tree/main/examples/oauth2-token-exchange-credentials>`_):
+(`full example <https://github.com/ydb-platform/ydb-python-sdk/tree/main/examples/oauth2-token-exchange-credentials>`__):
 
 .. code-block:: python
 

From 4d6cf384658f3ebb7b3dffc740c509864dbcb3fd Mon Sep 17 00:00:00 2001
From: Khabib <136262760+Khabib73@users.noreply.github.com>
Date: Mon, 7 Sep 2026 01:00:37 +0300
Subject: [PATCH 2/2] use html_show_sphinx

---
 docs/conf.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/conf.py b/docs/conf.py
index fb19c9773..271f740c8 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -88,6 +88,7 @@
 html_baseurl = 'https://ydb-platform.github.io/ydb-python-sdk/'
 
 html_show_sourcelink = False
+html_show_sphinx = False
 
 llms_txt_title = 'YDB Python SDK Documentation'
 llms_txt_summary = '''