remove uses of .. note:: in docs for now

Author: ndgrigorian

mkl_random/interfaces/_numpy_random.py

@@ -42,15 +42,14 @@ class RandomState(
 
     For full documentation refer to `numpy.random.RandomState`.
 
-    .. note::
-        *Compatibility Notice*
-
-        While this class shares its API with the original `RandomState`, it has
-        been rewritten to use MKL's vector statistics functionality, that
-        provides efficient implementation of the MT19937.
-        As a consequence, this version is NOT seed-compatible with the original
-        `RandomState` and the result of `get_state` is NOT compatible with the
-        original `RandomState`
+    Notes
+    -----
+    While this class shares its API with the original `RandomState`, it has
+    been rewritten to use MKL's vector statistics functionality, that
+    provides efficient implementation of the MT19937.
+    As a consequence, this version is NOT seed-compatible with the original
+    `RandomState` and the result of `get_state` is NOT compatible with the
+    original `RandomState`
 
     References
     -----
@@ -88,31 +87,29 @@ def get_state(self, legacy=True):
         out : {tuple(str, bytes), dict}
             The returned tuple has the following items:
 
-            1. a string specifying the basic psedo-random number generation
+            1. a string specifying the basic pseudo-random number generation
                algorithm. It should always be `MT19937` for this class.
             2. a bytes object holding content of Intel MKL's stream for the
                generator.
 
             If `legacy` is False, a dictionary containing the state information
             is returned instead, with the following keys:
 
-            1. `bit_generator`: a string specifying the basic psedo-random
+            1. `bit_generator`: a string specifying the basic pseudo-random
                 number generation algorithm. It should always be `MT19937`
                 for this class.
             2. `state`: a dictionary guaranteed to contain the key
-            `mkl_stream`, whose value is a bytes object holding content of
-            Intel MKL's stream for the generator.
+                `mkl_stream`, whose value is a bytes object holding content of
+                Intel MKL's stream for the generator.
 
             Compare with `numpy.random.get_state`.
 
-        .. note::
-            *Compatibility Notice*
-
+            Notes
+            -----
             As this class uses MKL in the backend, the state format is NOT
             compatible with the original `numpy.random.set_state`. The returned
             state represents the MKL stream state as a bytes object, which
             CANNOT be interpreted by NumPy's `RandomState`.
-
             The `legacy` argument is included for compatibility with the
             original `RandomState`.
         """
@@ -126,12 +123,11 @@ def set_state(self, state):
 
         For full documentation refer to `numpy.random.set_state`.
 
-        .. note::
-            *Compatibility Notice*
-
-            As this class uses MKL in the backend, the state of the generator
-            is NOT deterministic with states returned from the original
-            `numpy.random.get_state`.
+        Notes
+        -----
+        As this class uses MKL in the backend, the state of the generator
+        is NOT deterministic with states returned from the original
+        `numpy.random.get_state`.
 
         """
         return super().set_state(state=state)

mkl_random/mklrand.pyx

@@ -1655,7 +1655,7 @@ cdef class _MKLRandomState:
         out : {tuple(str, bytes), dict}
             The returned tuple has the following items:
 
-            1. a string specifying the basic psedo-random number generation
+            1. a string specifying the basic pseudo-random number generation
                algorithm.
             2. a bytes object holding content of Intel MKL's stream for the
                given BRNG.
@@ -1711,7 +1711,7 @@ cdef class _MKLRandomState:
         state : {tuple(str, bytes), dict}
             The `state` tuple has the following items:
 
-            1. a string specifying the basic psedo-random number generation
+            1. a string specifying the basic pseudo-random number generation
                algorithm.
             2. a bytes object holding content of Intel MKL's stream for the
                given BRNG.
@@ -6677,17 +6677,6 @@ cdef class MKLRandomState(_MKLRandomState):
     array filled with generated values is returned. If `size` is a tuple,
     then an array with that shape is filled and returned.
 
-    .. note::
-        *Compatibility Notice*
-
-        While this class shares some similarities with the original
-        `RandomState`, it has been rewritten to use MKL's vector statistics
-        functionality, that provides efficient implementation of the MT19937
-        and many other basic psuedo-random number generation algorithms as well
-        as efficient sampling from other common statistical distributions. As a
-        consequence this version is NOT seed-compatible with the original
-        `RandomState`.
-
     Parameters
     ----------
     seed : {None, int, array_like}, optional
@@ -6711,6 +6700,14 @@ cdef class MKLRandomState(_MKLRandomState):
     NumPy-aware, has the advantage that it provides a much larger number
     of probability distributions to choose from.
 
+    While this class shares some similarities with the original
+    `RandomState`, it has been rewritten to use MKL's vector statistics
+    functionality, that provides efficient implementation of the MT19937
+    and many other basic psuedo-random number generation algorithms as well
+    as efficient sampling from other common statistical distributions. As a
+    consequence this version is NOT seed-compatible with the original
+    `RandomState`.
+
     References
     -----
     MKL Documentation: https://www.intel.com/content/www/us/en/developer/tools/oneapi/onemkl.html  # no-cython-lint