Chef 13 Upgrade: `knife-cookbook-doc` Rubocop Updates

As part of an upgrade from Chef 12 to Chef 13, this is one of the posts in which I've been detailing the issues I've encountered, and how I've resolved them .

As mentioned in ‘Chef 13 Upgrade: knife-cookbook-doc gem upgrade’ I use the knife-cookbook-doc gem to autogenerate my cookbook documentation, with formatting of the formats:

# attributes.rb
#<> Caddy base download URL: Required to override until https://github.com/dzabel/chef-caddy/pull/1 is merged
default['caddy']['url'] = 'https://caddyserver.com/download/linux/amd64?'

# resources/site.rb
=begin
#<
@property fqdn to configure a site for. When Chef Envrionment is `staging`, the FQDN that is configured will be `staging.{fqdn}`
#>
=end
property :fqdn

However, with the upgrade to Chef 13, Rubocop has been throwing a number of errors, Do not use block comments.

This was an easy fix to add to my .rubocop.yml, allowing me to simply ignore them in the source files I was using them:

Style/BlockComments:
  Exclude:
    - 'attributes/default.rb'
    - 'recipes/*.rb'
    - 'resources/*.rb'

And although not technically part of the Chef 13 upgrade, I also wanted to note that I have the following exception for my attributes files, as they use the first format, which Rubocop isn’t happy about, either.

Layout/LeadingCommentSpace:
  Exclude:
    - 'attributes/default.rb'
*****