Merge pull request numpy#26340 from bmwoodruff/seedsequence-note

Author: ngoldbaum

doc/source/reference/random/index.rst

@@ -56,6 +56,8 @@ pseudo-randomness was good for in the first place.
   or cryptographic purposes. See the :py:mod:`secrets` module from the
   standard library for such use cases.
 
+.. _recommend-secrets-randbits:
+
 Seeds should be large positive integers. `default_rng` can take positive
 integers of any size. We recommend using very large, unique numbers to ensure
 that your seed is different from anyone else's. This is good practice to ensure

doc/source/reference/random/parallel.rst

@@ -45,6 +45,10 @@ These properties together mean that we can safely mix together the usual
 user-provided seed with simple incrementing counters to get `~BitGenerator`
 states that are (to very high probability) independent of each other. We can
 wrap this together into an API that is easy to use and difficult to misuse.
+Note that while `~SeedSequence` attempts to solve many of the issues related to
+user-provided small seeds, we still :ref:`recommend<recommend-secrets-randbits>`
+using :py:func:`secrets.randbits` to generate seeds with 128 bits of entropy to
+avoid the remaining biases introduced by human-chosen seeds.
 
 .. code-block:: python