rightscale-cookbooks / yard-chef

MIT License
49 stars 16 forks source link

How to document dynamic attributes? #24

Closed WalterS closed 6 years ago

WalterS commented 6 years ago

How would we document dynamic attributes? Previously, we had all attributes documented in metadata.rb which gave us maximum control over how the attributes are documented. But this is deprecated in Chef 13 and will be removed in Chef 14 according to the Chef documentation. We have a lot of cookbooks where attributes are defined in run-time according to architecture, network zone an so on where it seems not to be feasible to generate a documentation from the attributes file (see an example here). Is there another way to store the attribute definitions?

N.b. If you use the explicit attribute notation node.level yard-chef just ignores them.