ruff compliance for D405 and D407

.ruff.toml

@@ -31,17 +31,15 @@ lint.ignore = [
     "D102",  # Missing docstring in public method
     "D104",  # Missing docstring in public package
     "D106",  # Missing docstring in public nested class
-    # (D-3) Temporary, before an initial review, either fix ocurrenvces or move to (2).
+    # (D-3) Temporary, before an initial review, either fix ocurrences or move to (2).
     "D100",  # Missing docstring in public module
     "D103",  # Missing docstring in public function
     "D200",  # One-line docstring should fit on one line
     "D202",  # No blank lines allowed after function docstring
     "D205",  # 1 blank line required between summary line and description
     "D401",  # First line of docstring should be in imperative mood: ...
     "D404",  # First word of the docstring should not be "This"
-    "D405",  # Section name should be properly capitalized
     "D406",  # Section name should end with a newline
-    "D407",  # Missing dashed underline after section
 
     # pyupgrade (UP)
     # https://docs.astral.sh/ruff/rules/#pyupgrade-up

docs/src/developers_guide/documenting/docstrings_attribute.py

@@ -6,15 +6,16 @@ def __init__(self, arg1, arg2):
 
         Description section text.
 
-        Args:
-
-        * arg1 (int):
+        Parameters
+        ----------
+        arg1 : int
             First argument description.
-        * arg2 (float):
+        arg2 : float
             Second argument description.
 
-        Returns:
-            Boolean.
+        Returns
+        -------
+        bool
 
         """
         self.a = arg1
@@ -26,8 +27,9 @@ def __init__(self, arg1, arg2):
     def square(self):
         """*(read-only)* Purpose section description.
 
-        Returns:
-            int.
+        Returns
+        -------
+        int
 
         """
         return self.a * self.a

docs/src/developers_guide/documenting/docstrings_sample_routine.py

@@ -3,22 +3,21 @@ def sample_routine(arg1, arg2, kwarg1="foo", kwarg2=None):
 
     Description section longer text goes here.
 
-    Args:
-
-    * arg1 (numpy.ndarray):
+    Parameters
+    ----------
+    arg1 : numpy.ndarray
         First argument description.
-    * arg2 (numpy.ndarray):
+    arg2 : numpy.ndarray
         Second argument description.
-
-    Kwargs:
-
-    * kwarg1 (string):
+    kwarg1: str, optional
         The first keyword argument. This argument description
         can be multi-lined.
-    * kwarg2 (Boolean or None):
+    kwarg2 : bool or None, optional
         The second keyword argument.
 
-    Returns:
+    Returns
+    -------
+    numpy.ndarray
         numpy.ndarray of arg1 * arg2
 
     """