[chef] Re: Re: Re: CHEF-154 and upcoming change to runit cookbook

[Joshua Timberman < >]

Ohai,


On 1/24/13 1:38 PM, "Hedge Hog" 
<
 >
 wrote:

>This is an exemplary change notice.

Thanks :-D.

>Is there a Cookbook convention yet for distributing notices like these
>with a cookbook?

What we do now:

1. Update the CHANGELOG.md with the tickets in the release
2. Update the individual tickets with relevant information, if required.

Most cookbooks don't get this kind of dramatic change, though.

>Maybe a cookbook can have an optional notices folder, with markdown
>files named by the version number?
>
>cookbooks/runit/notices/0.16.2
>
>thoughts?

It's an interesting idea. However, the main issue I see is that it won't
end up in the cookbook shared on the community site. The only directories
there are the ones loaded by Chef (attributes, definitions, libraries,
providers, resources, recipes, files, templates). This means many users
who obtain cookbooks from the site won't have it, and would need to
reference the changelog, tickets, etc anyway.

-- 
Opscode, Inc
Joshua Timberman, Technical Community Manager
IRC, Skype, Twitter, Github: jtimberman