On 22/03/07, 80686@svn.wikimedia.org 80686@svn.wikimedia.org wrote:
Revision: 20615 Author: 80686 Date: 2007-03-22 01:08:08 -0800 (Thu, 22 Mar 2007)
Log Message:
updated release notes
The latest changes go at the *end* of the release notes.
Rob Church
On 3/22/07, Rob Church robchur@gmail.com wrote:
The latest changes go at the *end* of the release notes.
The intended audience for the release notes don't really care what order the changes were applied in to trunk. It would make rather more sense to organize them by bug number, or topically, to be honest.
On 22/03/07, Simetrical Simetrical+wikilist@gmail.com wrote:
On 3/22/07, Rob Church robchur@gmail.com wrote:
The latest changes go at the *end* of the release notes.
The intended audience for the release notes don't really care what order the changes were applied in to trunk. It would make rather more sense to organize them by bug number, or topically, to be honest.
I was stating the long-standing convention we have. If you'd like to start a dialogue on a better way to rearrange the release notes, then here's your thread.
Rob Church
Rob Church schrieb:
I was stating the long-standing convention we have. If you'd like to start a dialogue on a better way to rearrange the release notes, then here's your thread.
I start the dialogue...
Maybe we could split the section "== Changes since 1.9 ==" into "Enhancements/New features since 1.x" and "Bugfixes since 1.x". This is more friendly to read for all MediaWiki admins/users who are not daily updating from trunk.
And at the moment "Major new features" is empty...
Any objections against splitting/resorting the current release notes?
Another idea: What about extensions? Aren't they worth to be mentioned? At least the more important used on WMF projects? I know, this could be POV *hides*
Raymond.
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
Raimond Spekking wrote:
Maybe we could split the section "== Changes since 1.9 ==" into "Enhancements/New features since 1.x" and "Bugfixes since 1.x". This is more friendly to read for all MediaWiki admins/users who are not daily updating from trunk.
*thumbs up*
Another idea: What about extensions? Aren't they worth to be mentioned? At least the more important used on WMF projects? I know, this could be POV *hides*
Mentioned where? They're not part of a MediaWiki release, so RELEASE-NOTES maybe doesn't make sense. :)
- -- brion vibber (brion @ wikimedia.org)
Brion Vibber schrieb:
*thumbs up*
[X] Done. I hope, the sections and devision of existing entries are satisfying.
Mentioned where? They're not part of a MediaWiki release, so RELEASE-NOTES maybe doesn't make sense. :)
Ok, though the extensions are no part of MW release, what do you think about a separate RELEASE-NOTES EXTENSIONS in the extensions dir? Would it be useful?
Raymond.
Ok, though the extensions are no part of MW release, what do you think about a separate RELEASE-NOTES EXTENSIONS in the extensions dir? Would it be useful?
I wouldn't find this useful. However, if each extension had its own RELEASE-NOTES, this might help.
-- Jim R. Wilson (jimbojw)
On 3/23/07, Raimond Spekking raimond.spekking@gmail.com wrote:
Brion Vibber schrieb:
*thumbs up*
[X] Done. I hope, the sections and devision of existing entries are satisfying.
Mentioned where? They're not part of a MediaWiki release, so RELEASE-NOTES maybe doesn't make sense. :)
Ok, though the extensions are no part of MW release, what do you think about a separate RELEASE-NOTES EXTENSIONS in the extensions dir? Would it be useful?
Raymond.
Wikitech-l mailing list Wikitech-l@lists.wikimedia.org http://lists.wikimedia.org/mailman/listinfo/wikitech-l
On 23/03/07, Jim Wilson wilson.jim.r@gmail.com wrote:
I wouldn't find this useful. However, if each extension had its own RELEASE-NOTES, this might help.
I for one tend to have a README file for the extensions I've written and "published", and maintain a change log in that. I'm standardising the documentation format for mine on MediaWiki.org and including a decent change log there, too, e.g. http://www.mediawiki.org/wiki/Extension:Username_Blacklist.
Whether or not all extension writers could be encouraged to do the same is another matter.
Rob Church
wikitech-l@lists.wikimedia.org