cite NumPy 1.17 API
Random Sampling (``cupy.random``)
=================================
-.. https://docs.scipy.org/doc/numpy/reference/routines.random.html
+.. https://docs.scipy.org/doc/numpy-1.16.1/reference/routines.random.html
+.. https://docs.scipy.org/doc/numpy/reference/random/legacy.html
-The big difference of :mod:`cupy.random` from :mod:`numpy.random` is that :mod:`cupy.random` supports ``dtype`` option for most functions.
-This option enables us to generate float32 values directly without any space overhead.
+Differences between :mod:`cupy.random` and :mod:`numpy.random`:
-Unlike NumPy, CuPy allows itself to replace its random number generator across its major versions.
-It means that numbers generated by cupy.random of a new major version may not be the same as that of its previous one even if the same seed and distribution are used.
+* CuPy currently provides `Legacy Random Generation <https://docs.scipy.org/doc/numpy/reference/random/legacy.html>`_ API (see also: `NumPy 1.16 Reference <https://docs.scipy.org/doc/numpy-1.16.1/reference/routines.random.html>`_).
+ New random generator API (:class:`numpy.random.Generator` class) introduced in NumPy 1.17 is not implemented yet.
+* Most functions under :mod:`cupy.random` supports ``dtype`` option, which does not exist in the corresponding NumPy APIs.
+ This option enables us to generate float32 values directly without any space overhead.
+* CuPy does not guarantee that the same number generator is used across major versions.
+ This means that numbers generated by :mod:`cupy.random` of a new major version may not be the same as that of its previous one even if the same seed and distribution are used.
Sample random data
