Open Overbryd opened 8 years ago
Hi there,
the class itself is actually undocumented. Class documentation precedes the class definition and often describes the intended purpose of the class and sometimes usage examples:
# Base class for building linters that check source code
#
# Linters are used by authors of ROM adapters to verify that their
# integration complies with the ROM api.
#
# Most of the time, authors won't need to construct linters directly
# because the provided test helpers will automatically run when required
# in tests and specs.
#
# @example
# require 'rom/lint/spec'
#
#
# @api public
class Linter
# ... snip ...
end
Ah ok, good to know how inch sees this.
But it seems inch still sees the file lib/adyen_client/utils.rb
as the main AdyenClient file.
Although the class is now documented: https://github.com/Overbryd/adyen_client/blob/master/lib/adyen_client.rb
You are right about the incorrect file detection. Will have to look into it!
Inch CI says my class is undocumented, but it actually is. In the suggestion reference it used the class definition of one of the inner classes of this class.
See the fully documented class here: https://github.com/Overbryd/adyen_client/blob/37fbd929a6693394b702fd69f96cc51fedbab86d/lib/adyen_client.rb
Re: [U] AdyenClient in Overbryd/adyen_client