Merge pull request #118365 from Calinou/doc-randomnumbergenerator-rand-weighted

Improve `RandomNumberGenerator.rand_weighted()` description in the class reference