Update various docstrings.

colour/algebra/extrapolation.py

@@ -242,7 +242,7 @@ def left(self) -> Real | None:
 
         Returns
         -------
-        :py:data:`None` or Real
+        Real or :py:data:`None`
             Left value to return for x < xi[0].
         """
 
@@ -272,7 +272,7 @@ def right(self) -> Real | None:
 
         Returns
         -------
-        :py:data:`None` or Real
+        Real or :py:data:`None`
             Right value to return for x > xi[-1].
         """
 

colour/io/tm2714.py

@@ -257,7 +257,7 @@ def manufacturer(self) -> str | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             Manufacturer.
         """
 
@@ -287,7 +287,7 @@ def catalog_number(self) -> str | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             Catalog number.
         """
 
@@ -317,7 +317,7 @@ def description(self) -> str | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             Description.
         """
 
@@ -347,7 +347,7 @@ def document_creator(self) -> str | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             Document creator.
         """
 
@@ -377,7 +377,7 @@ def unique_identifier(self) -> str | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             Unique identifier.
         """
 
@@ -407,7 +407,7 @@ def measurement_equipment(self) -> str | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             Measurement equipment.
         """
 
@@ -437,7 +437,7 @@ def laboratory(self) -> str | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             Laboratory.
         """
 
@@ -467,7 +467,7 @@ def report_number(self) -> str | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             Report number.
         """
 
@@ -497,7 +497,7 @@ def report_date(self) -> str | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             Report date.
         """
 
@@ -527,7 +527,7 @@ def document_creation_date(self) -> str | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             Document creation date.
         """
 
@@ -557,7 +557,7 @@ def comments(self) -> str | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             Comments.
         """
 
@@ -1025,7 +1025,7 @@ def path(self) -> str | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             Path.
         """
 
@@ -1104,7 +1104,7 @@ def spectral_quantity(
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             Spectral quantity.
         """
 
@@ -1171,7 +1171,7 @@ def reflection_geometry(
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             Reflection geometry.
         """
 
@@ -1222,7 +1222,7 @@ def transmission_geometry(
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             Transmission geometry.
         """
 
@@ -1255,7 +1255,7 @@ def bandwidth_FWHM(self) -> float | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`float`
+        :class:`float` or :py:data:`None`
             Full-width half-maximum bandwidth.
         """
 
@@ -1288,7 +1288,7 @@ def bandwidth_corrected(self) -> bool | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`bool`
+        :class:`bool` or :py:data:`None`
             Whether bandwidth correction has been applied to the measured data.
         """
 

colour/models/rgb/rgb_colourspace.py

@@ -389,7 +389,7 @@ def whitepoint_name(self) -> str | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`str`
+        :class:`str` or :py:data:`None`
             *RGB* colourspace whitepoint name.
         """
 
@@ -506,7 +506,7 @@ def cctf_encoding(self) -> Callable | None:
 
         Returns
         -------
-        :py:data:`None` or Callable
+        Callable or :py:data:`None`
             Encoding colour component transfer function (Encoding CCTF) /
             opto-electronic transfer function (OETF).
         """
@@ -540,7 +540,7 @@ def cctf_decoding(self) -> Callable | None:
 
         Returns
         -------
-        :py:data:`None` or Callable
+        Callable or :py:data:`None`
             Decoding colour component transfer function (Decoding CCTF) /
             electro-optical transfer function (EOTF).
         """

colour/notation/munsell.py

@@ -2007,7 +2007,7 @@ def interpolation_method_from_renotation_ovoid(
 
     Returns
     -------
-    :py:data:`None` or :class:`str`
+    :class:`str` or :py:data:`None`
         Interpolation method.
 
     References

colour/recovery/otsu2018.py

@@ -768,7 +768,7 @@ def mean(self) -> NDArrayFloat | None:
 
         Returns
         -------
-        :py:data:`None` or :class:`numpy.ndarray`
+        :class:`numpy.ndarray` or :py:data:`None`
             Mean distribution.
         """