On Monday, September 9, 2013 at 11:27 AM, Michal Čihař wrote:
Hi
Dne Wed, 28 Aug 2013 21:29:26 -0400 Marc Delisle marc@infomarc.info napsal(a):
Le 2013-08-28 17:49, Isaac Bennetch a écrit :
At the meeting, someone (perhaps even me) suggested improved release notes. Yeah, we all know users should read ChangeLog for changes, but we also know many don't bother.
So I've taken it upon myself to draft a suggestion for the upcoming 4.0.6 release. It will require someone (yeah, probably me), to keep up with changes each release and I'm not sure whether that's going to be worth the effort we put in to it.
Anyway, the draft I've prepared is https://gist.github.com/ibennetch/ebe1879bcdf9b25212ca please let me know what you think
Maybe we need to talk more about the goal of the release notes.
The biggest goal IMHO is to let users know about big changes more prominently. We can do this either by including in notification mail, adding it to wiki or by putting this into documentation.
Some examples:
https://docs.djangoproject.com/en/1.5/releases/ http://docs.moodle.org/dev/Moodle_2.5.2_release_notes https://www.mediawiki.org/wiki/MediaWiki_1.22
I dont think there should be any bugfixes listed unless its a prominant bug. Same with small features. I believe it should be mostly breaking/major changes/fixes so that it is not the same as the changelog
-- Michal Èihaø | http://cihar.com | http://phpmyadmin.net
Learn the latest--Visual Studio 2012, SharePoint 2013, SQL 2012, more! Discover the easy way to master current and previous Microsoft technologies and advance your career. Get an incredible 1,500+ hours of step-by-step tutorial videos with LearnDevNow. Subscribe today and save! http://pubads.g.doubleclick.net/gampad/clk?id=58041391&iu=/4140/ostg.clk... _______________________________________________ Phpmyadmin-devel mailing list Phpmyadmin-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/phpmyadmin-devel