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

Update and fixup ActionController::Parameters docs #48250

Merged
merged 1 commit into from
May 18, 2023

Conversation

skipkayhil
Copy link
Member

Detail

  • Small wording tweaks for grammar or consistency
  • Add links to methods/classes when possible, and fix some cases where there were links but shouldn't be (API, Testing, etc.)
  • Fixed call-seq for each_key
  • Change has_key?, key?, and member? to aliases instead of delegates so that they are documented as aliases (This is how the methods are documented for Hash in Ruby)
  • Remove explicit "also aliased as" docs because rdoc does this already
  • Add :nodoc: to EMPTY_ARRAY and EMPTY_HASH constants since these are internal optimizations

Additional Information

Not skipping CI because of the delegate -> alias_method change

Checklist

Before submitting the PR make sure the following are checked:

  • This Pull Request is related to one change. Changes that are unrelated should be opened in separate PRs.
  • Commit message has a detailed description of what changed and why. If this PR fixes a related issue include it in the commit message. Ex: [Fix #issue-number]
  • Tests are added or updated if you fix a bug or add a feature.
  • CHANGELOG files are updated for the changed libraries if there is a behavior change or additional feature. Minor bug fixes and documentation changes should not be included.

- Small wording tweaks for grammar or consistency
- Add links to methods/classes when possible, and fix some cases where
  there were links but shouldn't be (`API`, `Testing`, etc.)
- Fixed `call-seq` for `each_key`
- Change `has_key?`, `key?`, and `member?` to aliases instead of
  delegates so that they are documented as aliases (This is how the
  methods are documented for Hash in Ruby)
- Remove explicit "also aliased as" docs because rdoc does this already
- Add `:nodoc:` to `EMPTY_ARRAY` and `EMPTY_HASH` constants since these
  are internal optimizations
@rails-bot rails-bot bot added the actionpack label May 18, 2023
@jonathanhefner jonathanhefner merged commit 1e34bf8 into rails:main May 18, 2023
9 checks passed
@jonathanhefner
Copy link
Member

jonathanhefner commented May 18, 2023

Thank you, @skipkayhil! 🗒️

Backported to 7-0-stable.

@skipkayhil skipkayhil deleted the hm-doc-ac-params branch May 18, 2023 15:18
jonathanhefner added a commit that referenced this pull request May 26, 2023
Update and fixup ActionController::Parameters docs

(cherry picked from commit 1e34bf8)
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