Restructure type references to be clearer

Author: sid-rl

docs/sdk/types.rst

@@ -1,27 +1,21 @@
 Type Reference
 ==============
 
-This page documents all TypeDict parameter types used throughout the SDK.
+The Runloop Python SDK uses TypeDict objects for configuration parameters to the various API calls. This page documents the TypeDict objects used throughout the SDK.
 
-Core Request Options
+Blueprint Parameters
 --------------------
 
-These TypeDicts define options for streaming, timeouts, polling, and other request configuration.
-
-.. autotypeddict:: runloop_api_client.sdk._types.ExecuteStreamingCallbacks
-
-.. autotypeddict:: runloop_api_client.sdk._types.RequestOptions
-
-.. autotypeddict:: runloop_api_client.sdk._types.LongRequestOptions
+These TypeDicts define parameters for blueprint creation and listing.
 
-.. autotypeddict:: runloop_api_client.sdk._types.PollingRequestOptions
+.. autotypeddict:: runloop_api_client.sdk._types.SDKBlueprintCreateParams
 
-.. autotypeddict:: runloop_api_client.sdk._types.LongPollingRequestOptions
+.. autotypeddict:: runloop_api_client.sdk._types.SDKBlueprintListParams
 
 Devbox Parameters
 -----------------
 
-These TypeDicts define parameters for devbox creation, execution, file operations, network tunnels, and snapshots.
+These TypeDicts define parameters for devbox creation, listing, and operations.
 
 Creation Parameters
 ~~~~~~~~~~~~~~~~~~~
@@ -30,18 +24,18 @@ Creation Parameters
 
 .. autotypeddict:: runloop_api_client.sdk._types.SDKDevboxCreateFromImageParams
 
-Execution Parameters
+Listing Parameters
+~~~~~~~~~~~~~~~~~~
+
+.. autotypeddict:: runloop_api_client.sdk._types.SDKDevboxListParams
+
+Command Execution Parameters
 ~~~~~~~~~~~~~~~~~~~~
 
 .. autotypeddict:: runloop_api_client.sdk._types.SDKDevboxExecuteParams
 
 .. autotypeddict:: runloop_api_client.sdk._types.SDKDevboxExecuteAsyncParams
 
-Listing Parameters
-~~~~~~~~~~~~~~~~~~
-
-.. autotypeddict:: runloop_api_client.sdk._types.SDKDevboxListParams
-
 File Operation Parameters
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -61,7 +55,9 @@ Network Tunnel Parameters
 .. autotypeddict:: runloop_api_client.sdk._types.SDKDevboxRemoveTunnelParams
 
 Snapshot Parameters
-~~~~~~~~~~~~~~~~~~~
+-------------------
+
+These TypeDicts define parameters for snapshot creation, listing, and updating.
 
 .. autotypeddict:: runloop_api_client.sdk._types.SDKDevboxSnapshotDiskParams
 
@@ -71,15 +67,6 @@ Snapshot Parameters
 
 .. autotypeddict:: runloop_api_client.sdk._types.SDKDiskSnapshotUpdateParams
 
-Blueprint Parameters
---------------------
-
-These TypeDicts define parameters for blueprint creation and listing.
-
-.. autotypeddict:: runloop_api_client.sdk._types.SDKBlueprintCreateParams
-
-.. autotypeddict:: runloop_api_client.sdk._types.SDKBlueprintListParams
-
 Storage Object Parameters
 -------------------------
 
@@ -90,3 +77,16 @@ These TypeDicts define parameters for storage object creation, listing, and down
 .. autotypeddict:: runloop_api_client.sdk._types.SDKObjectListParams
 
 .. autotypeddict:: runloop_api_client.sdk._types.SDKObjectDownloadParams
+
+Core Request Options
+--------------------
+
+These TypeDicts define options for timeouts, idempotency, polling, and other low-level request configuration. All other TypeDicts in the SDK extend from one of these core types.
+
+.. autotypeddict:: runloop_api_client.sdk._types.RequestOptions
+
+.. autotypeddict:: runloop_api_client.sdk._types.LongRequestOptions
+
+.. autotypeddict:: runloop_api_client.sdk._types.PollingRequestOptions
+
+.. autotypeddict:: runloop_api_client.sdk._types.LongPollingRequestOptions