Chris, This is a good suggestion. I think it is not too different from the release notes we have - http://people.apache.org/~nehanarkhede/kafka-0.7.0-incubating-candidate-5/RELEASE-NOTES.html
All details about the compression feature can be found in the wiki, which the release notes points to in the 1st section. Al though, maybe you are suggesting moving the "Features" section to the beginning of the release notes ? As for getting the word out about compression, I was thinking about writing a blog post on it. Does that address the concern you are raising ? Thanks, Neha On Mon, Oct 31, 2011 at 7:21 PM, Chris Burroughs <chris.burrou...@gmail.com> wrote: > On 10/31/2011 06:55 PM, Neha Narkhede wrote: >> Chris, please could you elaborate a little more on this ? I think if >> this is a small change, we can cut the RC today. >> > > I think we ought to include a NEWS file for users upgading from a > previous version. Projects varry in how they do this, some examples: > - http://rsync.samba.org/ftp/rsync/src/rsync-3.0.9-NEWS > - http://www.pcre.org/news.txt > - http://svn.apache.org/viewvc/couchdb/tags/1.1.0/NEWS?view=markup > - > http://svn.apache.org/viewvc/cassandra/tags/cassandra-1.0.1/NEWS.txt?revision=1195406&view=markup > > I like Cassandra's example with "here are the bigest new features" and > "things you need to know when upgrading". I think some of the others > function more as change logs, which isn't what I'm after. > > So for example, in this case we should point out that the wire format > has changed, their is a super cool compression feature, and you have to > upgrade the consumers, brokers, producers in that order. Anything else? >
