Fix the docstring of CommutationChecker.commute_nodes (#15991)

* Fix the docstring of `CommutationChecker.commute_nodes`

With the partial type hints the API docs only showed the last 2 parameters instead of all 4. also added some more explanations.

* Apply suggestion from @jakelishman

Co-authored-by: Jake Lishman <jake@binhbar.com>

---------

Co-authored-by: Jake Lishman <jake@binhbar.com>

Author: Cryoris

qiskit/circuit/commutation_checker.py

@@ -15,12 +15,16 @@
 from __future__ import annotations
 
 from collections.abc import Sequence
+import typing
 
 from qiskit.circuit.operation import Operation
 from qiskit.circuit import Qubit
 from qiskit._accelerate.commutation_checker import CommutationChecker as RustChecker
 from qiskit.utils import deprecate_arg, deprecate_func
 
+if typing.TYPE_CHECKING:
+    from qiskit.dagcircuit import DAGOpNode
+
 
 class CommutationChecker:
     r"""Check commutations of two operations.
@@ -61,12 +65,16 @@ def __init__(
 
     def commute_nodes(
         self,
-        op1,
-        op2,
+        op1: DAGOpNode,
+        op2: DAGOpNode,
         max_num_qubits: int = 3,
         approximation_degree: float = 1.0,
     ) -> bool:
-        """Checks if two DAGOpNodes commute."""
+        """Checks if two :class:`.DAGOpNode` objects commute.
+
+        This is equivalent to :meth:`commute` but with the operation, qubits, and clbits
+        bundled in the :class:`.DAGOpNode` object. See :meth:`commute` for more details.
+        """
         return self.cc.commute_nodes(op1, op2, max_num_qubits, approximation_degree, max_num_qubits)
 
     def commute(