Fix missing indentation and template functions not buildilng docs

qiskit/circuit/library/templates/clifford/clifford_2_1.py

@@ -10,20 +10,19 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 2_1:
-.. code-block:: text
-
-        q_0: ─■──■─
-              │  │
-        q_1: ─■──■─
-"""
-
 from qiskit.circuit.quantumcircuit import QuantumCircuit
 
 
 def clifford_2_1():
     """
+    Clifford template 2_1:
+
+    .. code-block:: text
+
+        q_0: ─■──■─
+              │  │
+        q_1: ─■──■─
+
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_2_2.py

@@ -10,21 +10,20 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 2_2:
-.. code-block:: text
+from qiskit.circuit.quantumcircuit import QuantumCircuit
+
+
+def clifford_2_2():
+    """
+    Clifford template 2_2:
+
+    .. code-block:: text
 
         q_0: ──■────■──
              ┌─┴─┐┌─┴─┐
         q_1: ┤ X ├┤ X ├
              └───┘└───┘
-"""
 
-from qiskit.circuit.quantumcircuit import QuantumCircuit
-
-
-def clifford_2_2():
-    """
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_2_3.py

@@ -10,19 +10,19 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 2_3:
-.. code-block:: text
-             ┌───┐┌───┐
-        q_0: ┤ H ├┤ H ├
-             └───┘└───┘
-"""
-
 from qiskit.circuit.quantumcircuit import QuantumCircuit
 
 
 def clifford_2_3():
     """
+    Clifford template 2_3:
+
+    .. code-block:: text
+
+             ┌───┐┌───┐
+        q_0: ┤ H ├┤ H ├
+             └───┘└───┘
+
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_2_4.py

@@ -10,20 +10,19 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 2_4:
-.. code-block:: text
-
-        q_0: ─X──X─
-              │  │
-        q_1: ─X──X─
-"""
-
 from qiskit.circuit.quantumcircuit import QuantumCircuit
 
 
 def clifford_2_4():
     """
+    Clifford template 2_4:
+
+    .. code-block:: text
+
+        q_0: ─X──X─
+              │  │
+        q_1: ─X──X─
+
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_3_1.py

@@ -10,20 +10,19 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 3_1:
-.. code-block:: text
-
-             ┌───┐┌───┐┌───┐
-        q_0: ┤ S ├┤ S ├┤ Z ├
-             └───┘└───┘└───┘
-"""
-
 from qiskit.circuit.quantumcircuit import QuantumCircuit
 
 
 def clifford_3_1():
     """
+    Clifford template 3_1:
+
+    .. code-block:: text
+
+             ┌───┐┌───┐┌───┐
+        q_0: ┤ S ├┤ S ├┤ Z ├
+             └───┘└───┘└───┘
+
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_4_1.py

@@ -10,22 +10,21 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 4_1:
-.. code-block:: text
+from qiskit.circuit.quantumcircuit import QuantumCircuit
+
+
+def clifford_4_1():
+    """
+    Clifford template 4_1:
+
+    .. code-block:: text
 
                   ┌───┐
         q_0: ──■──┤ X ├──■───X─
              ┌─┴─┐└─┬─┘┌─┴─┐ │
         q_1: ┤ X ├──■──┤ X ├─X─
              └───┘     └───┘
-"""
 
-from qiskit.circuit.quantumcircuit import QuantumCircuit
-
-
-def clifford_4_1():
-    """
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_4_2.py

@@ -10,21 +10,20 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 4_2:
-.. code-block:: text
+from qiskit.circuit.quantumcircuit import QuantumCircuit
+
+
+def clifford_4_2():
+    """
+    Clifford template 4_2:
+
+    .. code-block:: text
 
         q_0: ───────■────────■─
              ┌───┐┌─┴─┐┌───┐ │
         q_1: ┤ H ├┤ X ├┤ H ├─■─
              └───┘└───┘└───┘
-"""
 
-from qiskit.circuit.quantumcircuit import QuantumCircuit
-
-
-def clifford_4_2():
-    """
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_4_3.py

@@ -10,22 +10,21 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 4_3:
-.. code-block:: text
+from qiskit.circuit.quantumcircuit import QuantumCircuit
+
+
+def clifford_4_3():
+    """
+    Clifford template 4_3:
+
+    .. code-block:: text
 
              ┌───┐     ┌─────┐
         q_0: ┤ S ├──■──┤ SDG ├──■──
              └───┘┌─┴─┐└─────┘┌─┴─┐
         q_1: ─────┤ X ├───────┤ X ├
                   └───┘       └───┘
-"""
 
-from qiskit.circuit.quantumcircuit import QuantumCircuit
-
-
-def clifford_4_3():
-    """
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_4_4.py

@@ -10,21 +10,20 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 4_4:
-.. code-block:: text
+from qiskit.circuit.quantumcircuit import QuantumCircuit
+
+
+def clifford_4_4():
+    """
+    Clifford template 4_4:
+
+    .. code-block:: text
 
              ┌───┐   ┌─────┐
         q_0: ┤ S ├─■─┤ SDG ├─■─
              └───┘ │ └─────┘ │
         q_1: ──────■─────────■─
-"""
 
-from qiskit.circuit.quantumcircuit import QuantumCircuit
-
-
-def clifford_4_4():
-    """
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_5_1.py

@@ -10,23 +10,22 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 5_1:
-.. code-block:: text
+from qiskit.circuit.quantumcircuit import QuantumCircuit
+
+
+def clifford_5_1():
+    """
+    Clifford template 5_1:
+
+     .. code-block:: text
 
         q_0: ──■─────────■─────────■──
              ┌─┴─┐     ┌─┴─┐       │
         q_1: ┤ X ├──■──┤ X ├──■────┼──
              └───┘┌─┴─┐└───┘┌─┴─┐┌─┴─┐
         q_2: ─────┤ X ├─────┤ X ├┤ X ├
                   └───┘     └───┘└───┘
-"""
 
-from qiskit.circuit.quantumcircuit import QuantumCircuit
-
-
-def clifford_5_1():
-    """
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_6_1.py

@@ -10,22 +10,21 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 6_1:
-.. code-block:: text
+from qiskit.circuit.quantumcircuit import QuantumCircuit
+
+
+def clifford_6_1():
+    """
+    Clifford template 6_1:
+
+     .. code-block:: text
 
              ┌───┐     ┌───┐┌───┐
         q_0: ┤ H ├──■──┤ H ├┤ X ├
              ├───┤┌─┴─┐├───┤└─┬─┘
         q_1: ┤ H ├┤ X ├┤ H ├──■──
              └───┘└───┘└───┘
-"""
 
-from qiskit.circuit.quantumcircuit import QuantumCircuit
-
-
-def clifford_6_1():
-    """
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_6_2.py

@@ -10,22 +10,21 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 6_2:
-.. code-block:: text
+from qiskit.circuit.quantumcircuit import QuantumCircuit
+
+
+def clifford_6_2():
+    """
+    Clifford template 6_2:
+
+     .. code-block:: text
 
              ┌───┐
         q_0: ┤ S ├──■───────────■───■─
              ├───┤┌─┴─┐┌─────┐┌─┴─┐ │
         q_1: ┤ S ├┤ X ├┤ SDG ├┤ X ├─■─
              └───┘└───┘└─────┘└───┘
-"""
 
-from qiskit.circuit.quantumcircuit import QuantumCircuit
-
-
-def clifford_6_2():
-    """
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_6_3.py

@@ -10,22 +10,21 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 6_3:
-.. code-block:: text
+from qiskit.circuit.quantumcircuit import QuantumCircuit
+
+
+def clifford_6_3():
+    """
+    Clifford template 6_3:
+
+    .. code-block:: text
 
                    ┌───┐     ┌───┐
         q_0: ─X──■─┤ H ├──■──┤ X ├─────
               │  │ └───┘┌─┴─┐└─┬─┘┌───┐
         q_1: ─X──■──────┤ X ├──■──┤ H ├
                         └───┘     └───┘
-"""
 
-from qiskit.circuit.quantumcircuit import QuantumCircuit
-
-
-def clifford_6_3():
-    """
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """