Skip to main content

Chef/Sharing/EmptyPropertyDescription

Cookstyle cops page

The Cookstyle cops department: Chef/Sharing

Enabled by defaultSupports autocorrectionTarget Chef Version
EnabledNoAll Versions

Resource properties should not set an empty description. Automated documentation tools have nothing to render from it, so it does no more than a missing field would while looking like the property has been documented.

Examples

# bad
property :site_name, String,
         name_property: true,
         description: ''

# good
property :site_name, String,
         name_property: true,
         description: 'The name of the site'

Configurable attributes

NameDefault valueConfigurable values
Version Added9.0.0String
Include
  • **/libraries/*.rb
  • **/resources/*.rb
Array

Thank you for your feedback!

×