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

Fix: documentation of #step in Number and Char #10966

Merged
merged 1 commit into from
Jul 24, 2021

Conversation

beta-ziliani
Copy link
Member

As mentioned in a comment, the documentation got wrong :ditto for the step methods in Number. Here not only that is fixed, but also the documentation is improved and extended to Char.

@@ -122,6 +122,12 @@ struct Char
self - other
end

# Performs a `#step` in the direction of the _limit_. For instance:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The external name of the parameter is to. Should we use that or the internal one? 🤔

Suggested change
# Performs a `#step` in the direction of the _limit_. For instance:
# Performs a `#step` in the direction of _to_. For instance:

"limit" sounds better, and I suppose that's the entire reason for using an internal name. So it's probably fine as it is, just want to double check.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I also wonder about this and decided for limit but without being entirely convinced

@straight-shoota straight-shoota added this to the 1.2.0 milestone Jul 22, 2021
@straight-shoota straight-shoota merged commit 27d18e6 into crystal-lang:master Jul 24, 2021
@straight-shoota straight-shoota added kind:bug A bug in the code. Does not apply to documentation, specs, etc. kind:regression Something that used to correctly work but no longer works topic:stdlib:collection labels Jul 24, 2021
@straight-shoota straight-shoota modified the milestones: 1.2.0, 1.1.1 Jul 24, 2021
straight-shoota pushed a commit to straight-shoota/crystal that referenced this pull request Jul 24, 2021
@beta-ziliani beta-ziliani deleted the no-doc-step branch July 24, 2021 18:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
kind:bug A bug in the code. Does not apply to documentation, specs, etc. kind:docs kind:regression Something that used to correctly work but no longer works topic:stdlib:collection
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants