From 1702a47599b4abf2313436c4767bb1aefa88c240 Mon Sep 17 00:00:00 2001
From: Pedro Rivero <pedro.rivero.ramirez@gmail.com>
Date: Tue, 5 Mar 2024 14:11:05 -0500
Subject: [PATCH] docs(notebooks): add section titles to twirling guide

---
 docs/notebooks/twirling.ipynb | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/docs/notebooks/twirling.ipynb b/docs/notebooks/twirling.ipynb
index 8dc822f..92bfc11 100644
--- a/docs/notebooks/twirling.ipynb
+++ b/docs/notebooks/twirling.ipynb
@@ -24,6 +24,10 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
+    "## What is twirling?\n",
+    "```\n",
+    "Missing scientific/theoretical explanation\n",
+    "```\n",
     "Let us begin by introducing an auxiliary class `PauliTwirl`, to represent a single Pauli twirl:"
    ]
   },
@@ -91,6 +95,10 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
+    "## Operation-preserving twirls\n",
+    "```\n",
+    "Missing scientific/theoretical explanation\n",
+    "```\n",
     "Next we will create a helper function `generate_pauli_twirls` to compute all operation-preserving twirls for a given unitary matrix numerically:"
    ]
   },
@@ -130,7 +138,11 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Finally, with these tools, we can create a simple transpiler pass `TwoQubitPauliTwirlPass` to apply Pauli twirling to an input `DAGCircuit`:"
+    "## Random twirling\n",
+    "```\n",
+    "Missing scientific/theoretical explanation\n",
+    "```\n",
+    "Finally, with these tools, we can create a simple [transpiler pass](https://docs.quantum.ibm.com/transpile/custom-transpiler-pass#transpiler-passes) `TwoQubitPauliTwirlPass` to apply Pauli twirling to an input `DAGCircuit`:"
    ]
   },
   {
@@ -187,6 +199,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
+    "## Usage\n",
     "Using Qiskit's `PassManager` we can now run a simple example:"
    ]
   },