[chef] Re: Re: Re: Re: Re: Re: Documenting Cookbooks


Chronological Thread 
  • From: John Alberts < >
  • To:
  • Subject: [chef] Re: Re: Re: Re: Re: Re: Documenting Cookbooks
  • Date: Fri, 5 Apr 2013 09:20:49 -0500

Does anyone have any examples or tutorials for using yard-chef?  I glanced at some of the rightscale cookbooks, since they created yard-chef, and I don't see them using it in any of their cookbooks that I looked at.



On Fri, Apr 5, 2013 at 5:46 AM, Brian Akins < " target="_blank"> > wrote:
And until Chef Server has _anything_ to do with attributes in
metadata.rb, they are just "spam" and non-canonical, duplicated
attributes that may fall from accuracy/sync as time goes by.


+1

This is why I'm -1 on any documentation "standard" that  says put the documentation in some place other than in the attributes file. I've seen cookbooks here and there that have "documentation" in metadata.rb that has drifted from the attributes file(s).



--
John Alberts



Archive powered by MHonArc 2.6.16.

§