Hi Daniel On 13/05/2011, at 12:05 AM, Daniel Bartholomew wrote:
Ok, sorry about that. I saw the commit message "Merge with MySQL 5.1.57/58" from http://bazaar.launchpad.net/~maria-captains/maria/5.2/revision/2643.124.2 and just assumed that it meant all of 5.1.57 and .58 were merged.
Any suggestions for how to phrase it? I've removed "all of the" from the phrase "including all of the upstream changes from MySQL 5.1.57/58", and I've removed the links to the MySQL changelogs, but it's possible people might still assume that everything from 5.1.57/58 was merged.
Creating a list of each change that we actually pulled in seems like overkill for a Release Notes page (it's supposed to just be the abbreviated highlights of the release).
People must be able to assess what the version contains. I've previously noted that an external reference is less than optimal, but is there a precise changelog of the MariaDB release that lists exactly which modifications were made (and as a matter of interest, which upstream version they came from, where relevant). While I agree with you that the release notes don't necessarily have to contain everything, as that's what a changelog is for. However, the changelog should be there. So in a nutshell, I think the list of each change pulled *should* be made, the remaining issue being where to publish it - I'm fine with MariaDB release notes referring to MariaDB changelog for more detail. Ref to a bzr branch merge is not sufficient, IMHO... it would put a lot of hassle on the shoulders of users and other parties (many of whom don't even have the expertise to assess the bzr log info to that extent) and that kind of stuff seriously hinders adoption - and it can even trigger people moving away. Regards, Arjen. -- Arjen Lentz, Exec.Director @ Open Query (http://openquery.com) Remote expertise & maintenance for MySQL/MariaDB server environments. Follow us at http://openquery.com/blog/ & http://twitter.com/openquery