Ohai chefs!
RightScale published yard-chef a YARD plugin for auto-generating
cookbook documentation. It is available from RubyGems:
https://rubygems.org/gems/yard-chef
We have some example document generated from the rightscale_cookbooks:
http://yard-chef.s3.amazonaws.com/rightscale_cookbooks/20130418/index.html
We hope you find it useful!
Douglas Thrift
RightScale - Linux Systems Engineer
douglas.thrift@rightscale.com
http://www.rightscale.com/