don't document inheritance and undocumented members, and separate sync and async documentation into separate pages

Author: sid-rl

docs/conf.py

@@ -50,8 +50,6 @@
 # Autodoc settings
 autodoc_default_options = {
     "members": None,
-    "undoc-members": None,
-    "show-inheritance": None,
 }
 
 autodoc_typehints = "description"

docs/sdk/async.rst

@@ -0,0 +1,29 @@
+Asynchronous SDK
+================
+
+The asynchronous SDK provides a non-blocking interface for managing devboxes, blueprints, snapshots, and storage objects. Use this variant when working with async/await Python code.
+
+Core Module
+-----------
+
+The core asynchronous SDK module provides async operation classes.
+
+.. automodule:: runloop_api_client.sdk.async_
+
+Resource Modules
+----------------
+
+Asynchronous resource classes for working with devboxes, blueprints, snapshots, and more.
+
+.. automodule:: runloop_api_client.sdk.async_devbox
+
+.. automodule:: runloop_api_client.sdk.async_blueprint
+
+.. automodule:: runloop_api_client.sdk.async_snapshot
+
+.. automodule:: runloop_api_client.sdk.async_storage_object
+
+.. automodule:: runloop_api_client.sdk.async_execution
+
+.. automodule:: runloop_api_client.sdk.async_execution_result
+

docs/sdk/index.rst

@@ -3,104 +3,12 @@ SDK Reference
 
 This section contains detailed documentation for the Runloop SDK.
 
+The Runloop SDK provides both synchronous and asynchronous interfaces for managing devboxes, blueprints, snapshots, and storage objects. Choose the variant that matches your application's runtime requirements.
+
 .. toctree::
    :maxdepth: 2
+   :caption: SDK Documentation
 
+   sync
+   async
    types
-
-Synchronous SDK
----------------
-
-Core Module
-~~~~~~~~~~~
-
-The core synchronous SDK module provides the main entry point and operation classes.
-
-.. automodule:: runloop_api_client.sdk.sync
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-Resource Modules
-~~~~~~~~~~~~~~~~
-
-Synchronous resource classes for working with devboxes, blueprints, snapshots, and more.
-
-.. automodule:: runloop_api_client.sdk.devbox
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. automodule:: runloop_api_client.sdk.blueprint
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. automodule:: runloop_api_client.sdk.snapshot
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. automodule:: runloop_api_client.sdk.storage_object
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. automodule:: runloop_api_client.sdk.execution
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. automodule:: runloop_api_client.sdk.execution_result
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-Asynchronous SDK
-----------------
-
-Core Module
-~~~~~~~~~~~
-
-The core asynchronous SDK module provides async operation classes.
-
-.. automodule:: runloop_api_client.sdk.async_
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-Resource Modules
-~~~~~~~~~~~~~~~~
-
-Asynchronous resource classes for working with devboxes, blueprints, snapshots, and more.
-
-.. automodule:: runloop_api_client.sdk.async_devbox
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. automodule:: runloop_api_client.sdk.async_blueprint
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. automodule:: runloop_api_client.sdk.async_snapshot
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. automodule:: runloop_api_client.sdk.async_storage_object
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. automodule:: runloop_api_client.sdk.async_execution
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-.. automodule:: runloop_api_client.sdk.async_execution_result
-   :members:
-   :undoc-members:
-   :show-inheritance:
-

docs/sdk/sync.rst

@@ -0,0 +1,29 @@
+Synchronous SDK
+===============
+
+The synchronous SDK provides a blocking interface for managing devboxes, blueprints, snapshots, and storage objects. Use this variant when working in synchronous Python code.
+
+Core Module
+-----------
+
+The core synchronous SDK module provides the main entry point and operation classes.
+
+.. automodule:: runloop_api_client.sdk.sync
+
+Resource Modules
+----------------
+
+Synchronous resource classes for working with devboxes, blueprints, snapshots, and more.
+
+.. automodule:: runloop_api_client.sdk.devbox
+
+.. automodule:: runloop_api_client.sdk.blueprint
+
+.. automodule:: runloop_api_client.sdk.snapshot
+
+.. automodule:: runloop_api_client.sdk.storage_object
+
+.. automodule:: runloop_api_client.sdk.execution
+
+.. automodule:: runloop_api_client.sdk.execution_result
+