bpo-37624: Document weight assumptions for random.choices() (GH-14855)

diff --git a/Doc/library/random.rst b/Doc/library/random.rst
index fcedba4dbc2052c9367c13e2e842ef915a7b4d60..90b86248e6e1c3654886836998f2675fc03f571d 100644 (file)
--- a/Doc/library/random.rst
+++ b/Doc/library/random.rst
@@ -160,7 +160,8 @@ Functions for sequences
 
    The *weights* or *cum_weights* can use any numeric type that interoperates
    with the :class:`float` values returned by :func:`random` (that includes
-   integers, floats, and fractions but excludes decimals).
+   integers, floats, and fractions but excludes decimals).  Weights are
+   assumed to be non-negative.
 
    For a given seed, the :func:`choices` function with equal weighting
    typically produces a different sequence than repeated calls to