Separate out primitives

docs/api/qiskit-ibm-runtime/release-notes.mdx

@@ -1043,7 +1043,7 @@ The qiskit-ibm-runtime `v0.41.0` release focuses on the removal of IBM Quantum P
 
     `qiskit_ibm_runtime.RuntimeJob.program_id()` is deprecated and will be replaced by `qiskit_ibm_runtime.RuntimeJob.primitive_id()`. ([1238](https://github.com/Qiskit/qiskit-ibm-runtime/pull/1238))
 
-*   The `backend` argument in [Sampler](/docs/guides/get-started-with-primitives#3-initialize-the-qiskit-runtime-sampler) and [Estimator](/docs/guides/get-started-with-primitives#3-initialize-qiskit-runtime-estimator) has been deprecated. Please use `mode` instead. The `session` argument in [Sampler](/docs/guides/get-started-with-primitives#3-initialize-the-qiskit-runtime-sampler) and [Estimator](/docs/guides/get-started-with-primitives#3-initialize-qiskit-runtime-estimator) has also been deprecated. Please use `mode` instead. ([1556](https://github.com/Qiskit/qiskit-ibm-runtime/pull/1556))
+*   The `backend` argument in [Sampler](/docs/guides/get-started-with-sampler) and [Estimator](/docs/guides/get-started-with-estimator) has been deprecated. Please use `mode` instead. The `session` argument in [Sampler](/docs/guides/get-started-with-sampler) and [Estimator](/docs/guides/get-started-with-estimator) has also been deprecated. Please use `mode` instead. ([1556](https://github.com/Qiskit/qiskit-ibm-runtime/pull/1556))
 
 *   `qiskit_ibm_runtime.QiskitRuntimeService.get_backend()` is deprecated. Please [`qiskit_ibm_runtime.QiskitRuntimeService.backend()`](qiskit-runtime-service#backend "qiskit_ibm_runtime.QiskitRuntimeService.backend") use instead. The V1 fake backends, `FakeBackend`, along with `FakeProvider` are also being deprecated in favor of the V2 fake backends and [`FakeProviderForBackendV2`](fake-provider-fake-provider-for-backend-v2 "qiskit_ibm_runtime.fake_provider.FakeProviderForBackendV2"). ([1689](https://github.com/Qiskit/qiskit-ibm-runtime/pull/1689))
 
@@ -1182,7 +1182,7 @@ The qiskit-ibm-runtime `v0.41.0` release focuses on the removal of IBM Quantum P
 
 ### Upgrade Notes
 
-*   Circuits that do not match the target hardware definition are no longer supported by Qiskit Runtime primitives, unless `channel_strategy="q-ctrl"` is used. See the transpilation documentation ([transpile](/docs/guides/transpile)) for instructions to transform circuits and the primitive examples ([run/primitives-examples](/docs/guides/primitives-examples)) to see this coupled with operator transformations.
+*   Circuits that do not match the target hardware definition are no longer supported by Qiskit Runtime primitives, unless `channel_strategy="q-ctrl"` is used. See the transpilation documentation ([transpile](/docs/guides/transpile)) for instructions to transform circuits and the primitive examples ([run/primitives-examples](/docs/guides/estimator-examples)) to see this coupled with operator transformations.
 
 <span id="id123" />
 
@@ -1226,7 +1226,7 @@ The qiskit-ibm-runtime `v0.41.0` release focuses on the removal of IBM Quantum P
 
 ### Deprecation Notes
 
-*   Circuits that do not match the target hardware definition will no longer be supported after March 1, 2024. See the transpilation documentation ([transpile](/docs/guides/transpile)) for instructions to transform circuits and the primitive examples ([run/primitives-examples](/docs/guides/primitives-examples)) to see this coupled with operator transformations.
+*   Circuits that do not match the target hardware definition will no longer be supported after March 1, 2024. See the transpilation documentation ([transpile](/docs/guides/transpile)) for instructions to transform circuits and the primitive examples ([run/primitives-examples](/docs/guides/estimator-examples)) to see this coupled with operator transformations.
 
 <span id="id128" />
 

docs/guides/DAG-representation.ipynb

@@ -465,8 +465,8 @@
     "## Next steps\n",
     "\n",
     "<Admonition type=\"tip\" title=\"Recommendations\">\n",
-    "    - Review the guide on creating a [custom transpiler pass](./custom-transpiler-pass)\n",
-    "    - Learn how to [Create and transpile against custom backends](./custom-backend)\n",
+    "    - Review the guide on creating a [custom transpiler pass](/docs/guides/custom-transpiler-pass)\n",
+    "    - Learn how to [Create and transpile against custom backends](/docs/guides/custom-backend)\n",
     "    - Try the [Compare transpiler settings](/docs/guides/circuit-transpilation-settings) guide.\n",
     "    - Review the [DAG Circuit API documentation](/docs/api/qiskit/dagcircuit).\n",
     "</Admonition>"

docs/guides/_toc.json

@@ -226,6 +226,10 @@
               "title": "Primitive inputs and outputs",
               "url": "/docs/guides/primitive-input-output"
             },
+            {
+              "title": "Get started with the backend primitives",
+              "url": "/docs/guides/get-started-with-backend-primitives"
+            },
             {
               "title": "Exact simulation with Qiskit SDK primitives",
               "url": "/docs/guides/simulate-with-qiskit-sdk-primitives"
@@ -246,6 +250,10 @@
                   "title": "Exact and noisy simulation with Qiskit Aer primitives",
                   "url": "/docs/guides/simulate-with-qiskit-aer"
                 },
+                {
+              "title": "Exact simulation with Qiskit SDK primitives",
+              "url": "/docs/guides/simulate-with-qiskit-sdk-primitives"
+                },
                 {
                   "title": "Build noise models",
                   "url": "/docs/guides/build-noise-models"
@@ -483,51 +491,106 @@
             }
           ]
         },
-        {
-          "title": "Execute with primitives",
-          "children": [
-            {
-              "title": "Introduction to primitives",
-              "url": "/docs/guides/qiskit-runtime-primitives"
-            },
-            {
-              "title": "Get started with primitives",
-              "url": "/docs/guides/get-started-with-primitives"
-            },
-            {
-              "title": "Primitives examples",
-              "url": "/docs/guides/primitives-examples"
-            },
-            {
-              "title": "Primitives with REST API",
-              "url": "/docs/guides/primitives-rest-api"
-            },
-            {
-              "title": "Directed execution model (beta)",
-              "url": "/docs/guides/directed-execution-model"
-            },
-            {
-              "title": "Introduction to options",
-              "url": "/docs/guides/runtime-options-overview"
-            },
-            {
-              "title": "Specify options",
-              "url": "/docs/guides/specify-runtime-options"
-            },
-            {
-              "title": "Local verification",
-              "children": [
-            {
-              "title": "Qiskit Runtime local testing mode",
-              "url": "/docs/guides/local-testing-mode"
-            },
-            {
-                  "title": "Debug Qiskit Runtime jobs",
-                  "url": "/docs/guides/debug-qiskit-runtime-jobs"
-            }              ]
-            }
-          ]
-        },
+                {
+                    "title": "Execute with primitives",
+                    "children": [
+                        {
+                            "title": "Introduction to primitives",
+                            "url": "/docs/guides/qiskit-runtime-primitives"
+                        },
+                        {
+                          "title": "Directed execution model (beta)",
+                          "url": "/docs/guides/directed-execution-model"
+                        },
+                        {
+                            "title": "Introduction to options",
+                            "url": "/docs/guides/runtime-options-overview"
+                        },
+                    {
+                    "title": "Estimator",
+                    "children": [
+                            {
+                            "title": "Get started",
+                            "url": "/docs/guides/get-started-with-estimator"
+                            },
+                            {
+                            "title": "Inputs and outputs",
+                            "url": "/docs/guides/estimator-input-output"
+                            },
+                            {
+                            "title": "Options",
+                            "url": "/docs/guides/estimator-options"
+                            },
+                            {
+                            "title": "Configure noise management",
+                            "url": "/docs/guides/estimator-noise-management"
+                            },
+                            {
+                            "title": "Examples",
+                            "url": "/docs/guides/estimator-examples"
+                            },
+                            {
+                            "title": "REST API",
+                            "url": "/docs/guides/estimator-rest-api"
+                            }
+                        ]
+                    },
+                    {
+                    "title": "Sampler",
+                    "children": [
+                            {
+                            "title": "Get started",
+                            "url": "/docs/guides/get-started-with-sampler"
+                            },
+                            {
+                            "title": "Inputs and outputs",
+                            "url": "/docs/guides/sampler-input-output"
+                            },
+                            {
+                            "title": "Options",
+                            "url": "/docs/guides/sampler-options"
+                            },
+                            {
+                            "title": "Configure noise management",
+                            "url": "/docs/guides/sampler-noise-management"
+                            },
+                            {
+                            "title": "Examples",
+                            "url": "/docs/guides/sampler-examples"
+                            },
+                            {
+                            "title": "REST API",
+                            "url": "/docs/guides/sampler-rest-api"
+                            }
+                        ]
+                    },
+                   {
+                    "title": "Manage noise",
+                   "children": [
+                     {
+                       "title": "Overview of noise management techniques",
+                       "url": "/docs/guides/error-mitigation-overview"
+                      },
+                      {
+                        "title": "Error mitigation and suppression",
+                        "url": "/docs/guides/error-mitigation-and-suppression-techniques"
+                      },
+                      {
+                        "title": "Noise learning",
+                        "url": "/docs/guides/noise-learning"
+                      }
+                     ]
+                    },
+                        {
+                             "title": "Debug Qiskit Runtime jobs",
+                            "url": "/docs/guides/debug-qiskit-runtime-jobs"
+                         },
+                        {
+                            "title": "Qiskit Runtime local testing mode",
+                            "url": "/docs/guides/local-testing-mode"
+                        }
+                    ]
+                },
               {
                 "title": "Advanced execution features",
               "children": [
@@ -556,6 +619,10 @@
               "title": "View backend details",
               "url": "/docs/guides/qpu-information"
             },
+            {
+              "title": "Get backend information with Qiskit",
+              "url": "/docs/guides/get-qpu-information"
+            },
             {
               "title": "Monitoring, calibrations, and benchmarking",
               "url": "/docs/guides/calibration-jobs"
@@ -578,31 +645,6 @@
             }
           ]
         },
-        {
-          "title": "Manage noise",
-          "children": [
-            {
-              "title": "Overview of noise management techniques",
-              "url": "/docs/guides/error-mitigation-overview"
-            },
-            {
-              "title": "Error mitigation and suppression",
-              "url": "/docs/guides/error-mitigation-and-suppression-techniques"
-            },
-            {
-              "title": "Noise learning",
-              "url": "/docs/guides/noise-learning"
-            },
-            {
-              "title": "Configure error mitigation",
-              "url": "/docs/guides/configure-error-mitigation"
-            },
-            {
-              "title": "Configure error suppression",
-              "url": "/docs/guides/configure-error-suppression"
-            }
-          ]
-        },
         {
           "title": "Manage workload execution",
           "children": [

docs/guides/ai-transpiler-passes.ipynb

@@ -235,11 +235,11 @@
     "\n",
     "## Limits\n",
     "\n",
-    "Refer to the [Qiskit Transpiler Service documentation](./qiskit-transpiler-service#limits-of-the-qiskit-transpiler-service) for more information about the limits that apply to the AI-powered transpiler passes.\n",
+    "Refer to the [Qiskit Transpiler Service documentation](/docs/guides/qiskit-transpiler-service#limits-of-the-qiskit-transpiler-service) for more information about the limits that apply to the AI-powered transpiler passes.\n",
     "\n",
     "## Citation\n",
     "\n",
-    "If you use any AI-powered feature from the Qiskit Transpiler Service in your research, use [the recommended citation](./qiskit-transpiler-service#citation)."
+    "If you use any AI-powered feature from the Qiskit Transpiler Service in your research, use [the recommended citation](/docs/guides/qiskit-transpiler-service#citation)."
    ]
   }
  ],

docs/guides/build-noise-models.ipynb

@@ -596,7 +596,7 @@
    "source": [
     "### Note on non-local qubit quantum error\n",
     "\n",
-    "`NoiseModel` does not support addition of non-local qubit quantum errors. They should be handled outside of `NoiseModel`. That suggests you should [write your own transpiler pass](./custom-transpiler-pass) (`TransformationPass`) and run the pass just before running the simulator if you need to insert your quantum errors into your circuit under your own conditions."
+    "`NoiseModel` does not support addition of non-local qubit quantum errors. They should be handled outside of `NoiseModel`. That suggests you should [write your own transpiler pass](/docs/guides/custom-transpiler-pass) (`TransformationPass`) and run the pass just before running the simulator if you need to insert your quantum errors into your circuit under your own conditions."
    ]
   },
   {
@@ -978,7 +978,7 @@
     "## Next steps\n",
     "\n",
     "<Admonition type=\"tip\" title=\"Recommendations\">\n",
-    "  - To simulate noisy circuits, see [Exact and noisy simulation with Qiskit Aer primitives](./simulate-with-qiskit-sdk-primitives).\n",
+    "  - To simulate noisy circuits, see [Exact and noisy simulation with Qiskit Aer primitives](/docs/guides/simulate-with-qiskit-sdk-primitives).\n",
     "  - Review the [Qiskit Aer noise module](https://qiskit.org/ecosystem/aer/apidocs/aer_noise.html) reference.\n",
     "</Admonition>"
    ]

docs/guides/circuit-library.ipynb

@@ -492,7 +492,7 @@
     "## Next steps\n",
     "\n",
     "<Admonition type=\"tip\" title=\"Recommendations\">\n",
-    "  -  Learn advanced methods for creating circuits in the [Construct circuits](./construct-circuits) topic.\n",
+    "  -  Learn advanced methods for creating circuits in the [Construct circuits](/docs/guides/construct-circuits) topic.\n",
     "  -  See an example of circuits being used in the [Grover's Algorithm](/docs/tutorials/grovers-algorithm) tutorial.\n",
     "  -  Review the [circuit library API](/docs/api/qiskit/circuit_library) reference.\n",
     "</Admonition>"

docs/guides/cloud-setup-invited.mdx

@@ -12,7 +12,7 @@ If you do not have an invitation from an administrator to join an account that a
 You can run workloads on IBM® quantum processing units (QPUs) by setting up an account on IBM Cloud®. You will also need to [install and set up Qiskit and Qiskit Runtime](/docs/guides/install-qiskit#local).
 
 
-Your user account is associated with one or more [instances](./instances), identified by _Cloud Resource Names_ (CRNs) that give access to IBM Quantum services. Additionally, a unique API token (also called a key) is assigned to each account, allowing for IBM Quantum access from Qiskit.  For instructions to choose a specific instance, see [Connect to an instance](./instances#connect-instance).
+Your user account is associated with one or more [instances](/docs/guides/instances), identified by _Cloud Resource Names_ (CRNs) that give access to IBM Quantum services. Additionally, a unique API token (also called a key) is assigned to each account, allowing for IBM Quantum access from Qiskit.  For instructions to choose a specific instance, see [Connect to an instance](/docs/guides/instances#connect-instance).
 
     <Admonition type="note">
       The [IBM Quantum Platform dashboard](https://quantum.cloud.ibm.com) and the [Instances page](https://quantum.cloud.ibm.com/instances) list the instances that you can access.

docs/guides/compute-services.mdx

@@ -8,9 +8,9 @@ In addition to the open-source tools of the Qiskit SDK, Qiskit addons, and other
 
 ## Qiskit Runtime
 
-Qiskit Runtime is the cloud-based service for executing quantum computations on IBM Quantum hardware. The `qiskit-ibm-runtime` package is a client for that service, and is the successor to the Qiskit IBM Provider. The Qiskit Runtime service streamlines quantum computations and provides optimal implementations of Qiskit primitives for IBM Quantum hardware. To get started with primitives, visit the [documentation](/docs/guides/get-started-with-primitives).
+Qiskit Runtime is the cloud-based service for executing quantum computations on IBM Quantum hardware. The `qiskit-ibm-runtime` package is a client for that service, and is the successor to the Qiskit IBM Provider. The Qiskit Runtime service streamlines quantum computations and provides optimal implementations of Qiskit primitives for IBM Quantum hardware. To get started with primitives, visit the [documentation](/docs/guides/primitives).
 
-Qiskit Runtime is designed to use additional classical and quantum compute resources, including techniques such as error suppression and error mitigation, to return a higher-quality result from executing quantum circuits on quantum processors. Examples include dynamical decoupling for error suppression, and readout mitigation and zero-noise extrapolation (ZNE) for error mitigation. Learn how to configure these options on the [Configure error mitigation](/docs/guides/configure-error-mitigation) page.
+Qiskit Runtime is designed to use additional classical and quantum compute resources, including techniques such as error suppression and error mitigation, to return a higher-quality result from executing quantum circuits on quantum processors. Examples include dynamical decoupling for error suppression, and readout mitigation and zero-noise extrapolation (ZNE) for error mitigation. Learn how to configure these options on the [Configure error mitigation](/docs/guides/error-mitigation-and-suppression-techniques) page.
 
 
 Qiskit Runtime also includes three types of execution modes for running your quantum program on IBM® hardware: [Job, Session, and Batch](/docs/guides/execution-modes), each of which have different use cases and implications for the quantum job queue. A Job is a single query to a primitive that can be run over a specified number of shots. Sessions allow you to efficiently run multiple jobs in iterative workloads on quantum computers. Batch mode allows you to submit all your jobs at once for parallel processing. Note that Open Plan users cannot submit session jobs.