math/rand: package docs don't explain the interval notation #34655
Description
What version of Go are you using (go version)?
Whatever version the page at https://golang.org/pkg/math/rand/ is associated with.
Does this issue reproduce with the latest release?
It is present at the https://golang.org/pkg/math/rand/ page.
What operating system and processor architecture are you using (go env)?
Not relevant for reading docs.
What did you do?
Reading https://golang.org/pkg/math/rand/ I wanted to understand what interval notation the particular documentation page uses.
What did you expect to see?
"The documentation for this package uses interval notation with square brackets [, ] to denote included borders and round (, ) to denote excluded. For example, for n>0, [0, n) includes 0 but excludes n."
What did you see instead?
"Mathematical interval notation such as [0, n) is used throughout the documentation for this package."
I'm afraid there is no such thing as "mathematical interval notation". Different mathematicians define different notation. I propose that the mentioned documentation also properly defines the notation used in it. Ideally directly, or at least linking to the source of that notation.