Fix Raises sections which caused rendering issues

Author: rgommers

Diff for: src/array_api_stubs/_draft/linalg.py

@@ -72,13 +72,6 @@ def cross(x1: array, x2: array, /, *, axis: int = -1) -> array:
         an array containing the cross products. The returned array must have a data type determined by :ref:`type-promotion`.
 
 
-    Raises
-    ------
-
-    -   if provided an invalid ``axis``.
-    -   if the size of the axis over which to compute the cross product is not equal to ``3``.
-    -   if the size of the axis over which to compute the cross product is not the same (before broadcasting) for both ``x1`` and ``x2``.
-
     Notes
     -----
 
@@ -87,6 +80,11 @@ def cross(x1: array, x2: array, /, *, axis: int = -1) -> array:
 
     .. versionchanged:: 2022.12
        Added complex data type support.
+
+    **Raises**
+
+    -   if the size of the axis over which to compute the cross product is not equal to ``3``.
+    -   if the size of the axis over which to compute the cross product is not the same (before broadcasting) for both ``x1`` and ``x2``.
     """
 
 

Diff for: src/array_api_stubs/_draft/linear_algebra_functions.py

@@ -32,20 +32,20 @@ def matmul(x1: array, x2: array, /) -> array:
 
         The returned array must have a data type determined by :ref:`type-promotion`.
 
-    Raises
-    ------
+    Notes
+    -----
+
+    .. versionchanged:: 2022.12
+       Added complex data type support.
+
+    **Raises**
 
     -   if either ``x1`` or ``x2`` is a zero-dimensional array.
     -   if ``x1`` is a one-dimensional array having shape ``(K,)``, ``x2`` is a one-dimensional array having shape ``(L,)``, and ``K != L``.
     -   if ``x1`` is a one-dimensional array having shape ``(K,)``, ``x2`` is an array having shape ``(..., L, N)``, and ``K != L``.
     -   if ``x1`` is an array having shape ``(..., M, K)``, ``x2`` is a one-dimensional array having shape ``(L,)``, and ``K != L``.
     -   if ``x1`` is an array having shape ``(..., M, K)``, ``x2`` is an array having shape ``(..., L, N)``, and ``K != L``.
 
-    Notes
-    -----
-
-    .. versionchanged:: 2022.12
-       Added complex data type support.
     """
 
 
@@ -145,17 +145,15 @@ def vecdot(x1: array, x2: array, /, *, axis: int = -1) -> array:
     out: array
         if ``x1`` and ``x2`` are both one-dimensional arrays, a zero-dimensional containing the dot product; otherwise, a non-zero-dimensional array containing the dot products and having rank ``N-1``, where ``N`` is the rank (number of dimensions) of the shape determined according to :ref:`broadcasting` along the non-contracted axes. The returned array must have a data type determined by :ref:`type-promotion`.
 
-    Raises
-    ------
-
-    -   if provided an invalid ``axis``.
-    -   if the size of the axis over which to compute the dot product is not the same (before broadcasting) for both ``x1`` and ``x2``.
-
     Notes
     -----
 
     .. versionchanged:: 2022.12
        Added complex data type support.
+
+    **Raises**
+
+    -   if the size of the axis over which to compute the dot product is not the same (before broadcasting) for both ``x1`` and ``x2``.
     """