class RuboCop::Cop::Style::DocumentationMethod
end
end
def do_something
# Documentation
private
class Foo
end
end
def do_something
# Documentation
protected
class Foo
# good
end
end
def do_something
private
class Foo
end
end
def do_something
protected
class Foo
# bad
@example RequireForNonPublicMethods: true
end
end
def do_something
private
class Foo
end
end
def do_something
protected
class Foo
# good
@example RequireForNonPublicMethods: false (default)
end
puts baz
def foo.bar
# Documentation
end
end
puts baz
def bar
# Documentation
module Foo
end
end
puts baz
def bar
# Documentation
class Foo
# good
end
puts baz
def foo.bar
end
end
puts baz
def bar
module Foo
end
end
puts baz
def bar
class Foo
# bad
@example
they are called constructor to distinguish it from method.
a special method called from ‘new`. In some programming languages
NOTE: This cop allows `initialize` method because `initialize` is
non-public methods.
It can optionally be configured to also require documentation for
Checks for missing documentation comment for public methods.
def check(node)
def check(node) return if non_public?(node) && !require_for_non_public_methods? return if documentation_comment?(node) add_offense(node) end
def on_def(node)
def on_def(node) return if node.method?(:initialize) parent = node.parent modifier_node?(parent) ? check(parent) : check(node) end
def require_for_non_public_methods?
def require_for_non_public_methods? cop_config['RequireForNonPublicMethods'] end