Knife plugin to generate from metadata.rb
Latest commit dcad1fe Nov 19, 2014 @mlafeldt Merge pull request #7 from ldanz/stub_time
Fix broken test by stubbing current time to be in 2013


This is a Knife plugin to generate a skeleton file from a cookbook's metadata.rb file.

  • create the first bits of documentation you can build upon
  • write documentation that is consistent among your or your team's cookbooks
  • implement the DRY/SPOT rule (metadata.rb is the authoritative source of information)


You can install the plugin via RubyGems:

$ gem install knife-cookbook-readme

Alternatively, you can install the plugin from source:

$ git clone git://
$ cd knife-cookbook-readme/
$ bundle install
$ bundle exec rake install

Afterwards, the new knife command knife cookbook readme from FILE will be available.


knife cookbook readme from FILE (options)

    -t, --template FILE              Set template file used to render


    knife cookbook readme from path/to/metadata.rb
    knife cookbook readme from path/to/metadata.rb --template

Note that the command will write the generated output to STDOUT. Simply redirect the output to to write to a file.


Here is a list of other documentation tools for Chef (sorted alphabetically):


Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request