OK, I'll bite. Here is a first rough draft for discussion and brain-storming, please post suggestions for add'l hash keys. Basic format of Changes.yml should be a stream of hashes, each hash defining one release. --- version: 0.02 # plain number or version string, required released: 2007-09-06 # datestring, required author: Roland Giersig <RGiersig@cpan.org> # release author, required stability: draft # stable | draft, required backward-compatibility: partial # full | partial | none, required breaks-compatibility-in: # list of subs, optional - foo() - bar() bugs-fixed: # list of bugs with references, optional - foo() crashes when given undef parameter <http://rt.cpan.org/Ticket/Display.html?id=1234> - bar() should return "blah" changes: # list of text, required - rearranged arguments to foo() - changed return value of bar() --- version: 0.01 released: 2007-09-05 author: Roland Giersig <RGiersig@cpan.org> # release author, required stability: draft backward-compatibility: none changes: - first release ---
