On Wed, 12 May 2010, Alexandre Julliard wrote: > Scott Ritchie <sc...@open-vote.org> writes: > > > On 05/09/2010 05:00 PM, Alexandre Julliard wrote: > >> We definitely need a release changelog, yes. > > > > It seems to me what we really want is more than a changelog but a proper > > release announcement. I want a journalist who has hardly heard of Wine > > to read the page and understand what we've done and why it's great. > > Sure, that's the press release, we should have one too, but it's a > different thing. A changelog would be a detailed description of changes > that matter from a user point of view. It would list for instance new > builtin programs, new configuration options, new behaviors, new system > dependencies, backwards compatibility concerns, etc.
Isn't that more a release notes document? So we'd have: * Press Release Announcing the new Wine to the world at large. Must be readable by people who have never heard of Wine before. * Release notes A user friendly and high-level description what's new and what's changed. * Changelog A detailed description of what's changed from a developper perspective, that is the usual list of commit messages. -- Francois Gouget <fgou...@free.fr> http://fgouget.free.fr/ If it stinks, it's chemistry. If it moves, it's biology. If it does not work, It's computer science.