From 9950102335ba4bc47e1004c25ebebaf2e89e5a46 Mon Sep 17 00:00:00 2001
From: Jessie Yu <jessieyu@us.ibm.com>
Date: Wed, 17 Jul 2024 17:55:02 -0400
Subject: [PATCH 1/2] break up options classes

---
 qiskit_ibm_runtime/options/__init__.py | 39 ++++++++++++++++++++++----
 qiskit_ibm_runtime/options/options.py  |  2 +-
 2 files changed, 34 insertions(+), 7 deletions(-)

diff --git a/qiskit_ibm_runtime/options/__init__.py b/qiskit_ibm_runtime/options/__init__.py
index c3a540b8f..c79adc218 100644
--- a/qiskit_ibm_runtime/options/__init__.py
+++ b/qiskit_ibm_runtime/options/__init__.py
@@ -17,7 +17,7 @@
 
 .. currentmodule:: qiskit_ibm_runtime.options
 
-Options that can be passed to the primitives.
+Options that can be passed to the Qiskit Runtime primitives.
 
 V2 Primitives
 =============
@@ -75,11 +75,23 @@
 Classes
 =======
 
+Base Primitive Options
+----------------------
+
 .. autosummary::
    :toctree: ../stubs/
 
    EstimatorOptions
    SamplerOptions
+   Options
+
+
+Suboptions for V2 primitives only
+---------------------------------
+
+.. autosummary::
+   :toctree: ../stubs/
+
    DynamicalDecouplingOptions
    ResilienceOptionsV2
    LayerNoiseLearningOptions
@@ -88,13 +100,28 @@
    ZneOptions
    TwirlingOptions
    ExecutionOptionsV2
-   Options
-   TranspilationOptions
-   ResilienceOptions
-   ExecutionOptions
+   SamplerExecutionOptionsV2
+
+
+Suboptions for both V1 and V2 primitives
+----------------------------------------
+
+.. autosummary::
+   :toctree: ../stubs/
+
    EnvironmentOptions
    SimulatorOptions
-   SamplerExecutionOptionsV2
+
+
+Suboptions for V1 primitives only
+---------------------------------
+
+.. autosummary::
+   :toctree: ../stubs/
+
+   TranspilationOptions
+   ExecutionOptions
+   ResilienceOptions
 
 """
 
diff --git a/qiskit_ibm_runtime/options/options.py b/qiskit_ibm_runtime/options/options.py
index e8e681cce..596d54e61 100644
--- a/qiskit_ibm_runtime/options/options.py
+++ b/qiskit_ibm_runtime/options/options.py
@@ -233,7 +233,7 @@ def _set_if_exists(name: str, _inputs: dict, _options: dict) -> None:
 
 @dataclass
 class Options(BaseOptions):
-    """Options for the primitives, used by V1 primitives.
+    """Options for V1 primitives.
 
     Args:
         optimization_level: How much optimization to perform on the circuits.

From c09cb06973b8fb93f00bec158fc46a6e6b3bb351 Mon Sep 17 00:00:00 2001
From: Jessie Yu <jessieyu@us.ibm.com>
Date: Wed, 17 Jul 2024 17:59:47 -0400
Subject: [PATCH 2/2] use lower case

---
 qiskit_ibm_runtime/options/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qiskit_ibm_runtime/options/__init__.py b/qiskit_ibm_runtime/options/__init__.py
index c79adc218..4b47dd974 100644
--- a/qiskit_ibm_runtime/options/__init__.py
+++ b/qiskit_ibm_runtime/options/__init__.py
@@ -75,7 +75,7 @@
 Classes
 =======
 
-Base Primitive Options
+Base primitive options
 ----------------------
 
 .. autosummary::