Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

math/rand: package docs don't explain the interval notation #34655

vabr-g opened this issue Oct 2, 2019 · 3 comments

math/rand: package docs don't explain the interval notation #34655

vabr-g opened this issue Oct 2, 2019 · 3 comments


Copy link

@vabr-g vabr-g commented Oct 2, 2019

What version of Go are you using (go version)?

Whatever version the page at is associated with.

Does this issue reproduce with the latest release?

It is present at the page.

What operating system and processor architecture are you using (go env)?

Not relevant for reading docs.

What did you do?

Reading 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.

Copy link

@ianlancetaylor ianlancetaylor commented Oct 2, 2019

The notation we use here is the one described at That seems sufficiently well-known and standardized to me.

@ianlancetaylor 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
@ianlancetaylor ianlancetaylor added this to the Unplanned milestone Oct 2, 2019
Copy link

@vabr-g vabr-g commented Oct 2, 2019

Could the definition you linked to be at least linked to from the documentation itself?

Copy link

@andybons andybons commented Oct 2, 2019

Thanks for the issue.

Searching via Google for "interval notation" provides several results that cover this notation in depth (including the Wikipedia entry @ianlancetaylor provided).

Linking seems unnecessary. Sorry.

@andybons andybons closed this Oct 2, 2019
@golang golang locked and limited conversation to collaborators Oct 1, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
4 participants
You can’t perform that action at this time.