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 #11504] Allow initialize method in Style/DocumentationMethod #11506

Conversation

koic
Copy link
Member

@koic koic commented Jan 26, 2023

Fixes #11504.

This PR makes to allow initialize method in Style/DocumentationMethod because initialize is a special method called from new. In some languages they are called constructor to distinguish it from method.

So it would be different from the following intent that this cop wants to detect.

Checks for missing documentation comment for public methods.
It can optionally be configured to also require documentation for
non-public methods.


Before submitting the PR make sure the following are checked:

  • The PR relates to only one subject with a clear title and description in grammatically correct, complete sentences.
  • Wrote good commit messages.
  • Commit message starts with [Fix #issue-number] (if the related issue exists).
  • Feature branch is up-to-date with master (if not - rebase it).
  • Squashed related commits together.
  • Added tests.
  • Ran bundle exec rake default. It executes all tests and runs RuboCop on its own code.
  • Added an entry (file) to the changelog folder named {change_type}_{change_description}.md if the new code introduces user-observable changes. See changelog entry format for details.

@koic koic force-pushed the allow_initialize_method_in_sytle_documentation_method branch from e9f0187 to 735ba6d Compare January 26, 2023 04:26
…Method`

Fixes rubocop#11504.

This PR makes to allow `initialize` method in `Style/DocumentationMethod`
because `initialize` is a special method called from `new`.
In some languages they are called constructor to distinguish it from method.

So it would be different from the following intent that this cop wants to detect.

> Checks for missing documentation comment for public methods.
> It can optionally be configured to also require documentation for
> non-public methods.
@koic koic force-pushed the allow_initialize_method_in_sytle_documentation_method branch from 735ba6d to c9dd42d Compare January 26, 2023 04:46
@bbatsov bbatsov merged commit 61a0da1 into rubocop:master Jan 26, 2023
@bbatsov
Copy link
Collaborator

bbatsov commented Jan 26, 2023

Fine by me. Thanks!

@koic koic deleted the allow_initialize_method_in_sytle_documentation_method branch January 26, 2023 07:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add option to exclude methods for Style/DocumentationMethod cop
2 participants