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

More docs cleanup #3942

Merged
merged 2 commits into from Jan 28, 2017
Merged

More docs cleanup #3942

merged 2 commits into from Jan 28, 2017

Conversation

Sija
Copy link
Contributor

@Sija Sija commented Jan 27, 2017

This PR contains 2nd batch of docs cleanup:

  • Linkified RFCs
  • Marked missing argument_names
  • Marked missing ClassNames
  • Fixed typos found throughout the codebase
  • Misc small fixes

Copy link

@mverzilli mverzilli left a comment

Choose a reason for hiding this comment

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

Thank you for this! ❤️ . Just a few corrections and we're good to merge.

# this invokes `includes?`. For example:
# An enum automatically defines question methods for each member, using
# `String#underscore` for the method name.
# * If the case of regular enums, this compares by equality (`==`).

Choose a reason for hiding this comment

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

Should be "In the case of regular enums [...]"

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Fixed.

@@ -1,6 +1,6 @@
require "./openssl/lib_ssl"

# # OpenSSL Integration
# ## Integration

Choose a reason for hiding this comment

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

Why remove the OpenSSL here? It might be a bit redundant, but I think it's anyway more clear in this case to leave OpenSSL Integration

@@ -16,13 +16,13 @@ require "base64"
# ```
#
# The implementation follows the
# [libsodium sysrandom](https://github.com/jedisct1/libsodium/blob/6fad3644b53021fb377ca1207fa6e1ac96d0b131/src/libsodium/randombytes/sysrandom/randombytes_sysrandom.c)
# [libsodium sysrandom](https://github.com/jedisct1/libsodium/blob/master/src/libsodium/randombytes/sysrandom/randombytes_sysrandom.c)

Choose a reason for hiding this comment

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

Isn't it better to point this to a specific commit as it used to? master may break, for example if they rename or move the file.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

You're right, had a bad feeling about that too, I'll change it back.

@mverzilli mverzilli merged commit b52b2f9 into crystal-lang:master Jan 28, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants