You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
"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.
The text was updated successfully, but these errors were encountered:
ianlancetaylor
changed the title
The docs for package "math/rand" don't explain the interval notation
math/rand: package docs don't explain the interval notation
Oct 2, 2019
Searching via Google for "interval notation" provides several results that cover this notation in depth (including the Wikipedia entry @ianlancetaylor provided).
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.
The text was updated successfully, but these errors were encountered: