[chef] Re: Re: Re: Centralized cookbook-library repos vs distributed cookbook repos


Chronological Thread 
  • From: Dan DeMaggio < >
  • To:
  • Subject: [chef] Re: Re: Re: Centralized cookbook-library repos vs distributed cookbook repos
  • Date: Fri, 9 Apr 2010 16:15:21 -0400

On Fri, Apr 9, 2010 at 12:03 PM, dreamcat four 
< >
 wrote:
> Maybe if the documentation is just extra metadata within the source
> code. So what about a yard plugin for chef?

I agree. In a perfect world:
- the metadata should be generated from inline comments. Attribute
metadata would be declared in the attribute/ files, and Recipe
metadata (parameters) would be declared in the recipe. (Ditto for
macros, etc). This would make it much harder for the metadata to drift
out of sync.
- the metadata extractor should be part of chef (not in a rake file
that needs to be copied into every project!)
- the chef server should just scan the recipes for metadata. (not run
them, but just parse the comments). So we wouldn't even need
metadata(.json|.rb) at all. That also solves the "why do I need to
check in a generated file?" problem too.

Currently, I don't use metadata or rake files in my cookbooks.
(Granted, I'm using chef-solo.)

-=Dan=-



Archive powered by MHonArc 2.6.16.

§