On Wed, 12 May 2010, Alexandre Julliard wrote:
Scott Ritchie scott@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.