| Index: branches/REL1_17/phase3/RELEASE-NOTES |
| — | — | @@ -1,41 +1,43 @@ |
| 2 | 2 | = MediaWiki release notes = |
| 3 | 3 | |
| 4 | 4 | Security reminder: MediaWiki does not require PHP's register_globals |
| 5 | | -setting since version 1.2.0. If you have it on, turn it *off* if you can. |
| | 5 | +setting since version 1.2.0. If you have it on, turn it '''off''' if you can. |
| 6 | 6 | |
| 7 | | -== MediaWiki 1.17 == |
| | 7 | +== MediaWiki 1.17 beta 1 == |
| 8 | 8 | |
| 9 | | -THIS IS NOT A RELEASE YET |
| | 9 | +2011-05-04 |
| 10 | 10 | |
| 11 | | -MediaWiki is now using a "continuous integration" development model with |
| 12 | | -quarterly snapshot releases. The latest development code is always kept |
| 13 | | -"ready to run", and in fact runs our own sites on Wikipedia. |
| | 11 | +This is a beta release of the MediaWiki 1.17 branch. Please test it and let us |
| | 12 | +know what you think of it. Beta releases are not recommended for use in |
| | 13 | +production. |
| 14 | 14 | |
| 15 | | -Release branches will continue to receive security updates for about a year |
| 16 | | -from first release, but nonessential bugfixes and feature developments |
| 17 | | -will be made on the development trunk and appear in the next quarterly release. |
| | 15 | +=== Summary of selected changes in 1.17 === |
| 18 | 16 | |
| 19 | | -Those wishing to use the latest code instead of a branch release can obtain |
| 20 | | -it from source control: http://www.mediawiki.org/wiki/Download_from_SVN |
| | 17 | +Selected changes since MediaWiki 1.16 that may be of interest: |
| 21 | 18 | |
| 22 | | -=== PHP 5.2 now required == |
| 23 | | -Since 1.17, the lowest supported version of MediaWiki is now 5.2.3. Please |
| 24 | | -upgrade PHP if you have not done so prior to upgrading MediaWiki. |
| | 19 | +* A new installer has been introduced. It has a wizard-style interface which is |
| | 20 | + translated into many languages. Many shortcomings in the old installer were |
| | 21 | + addressed with this rewrite. Note that it is no longer required for the config |
| | 22 | + directory to be made writable by the webserver. Instead the generated |
| | 23 | + LocalSettings.php file is offered as a download, which you must then upload |
| | 24 | + to the wiki's base directory. |
| 25 | 25 | |
| 26 | | -=== New installer in 1.17 === |
| 27 | | -MediaWiki 1.17 is shipping with a completely redesigned installer to fix |
| 28 | | -a lot of outstanding bugs, cleanup the code quality, and make it easier to |
| 29 | | -use. Notably, you can now run upgrades from the web without having to move |
| 30 | | -LocalSettings.php. Also, configuration script directory has been renamed |
| 31 | | -from config/ to mw-config/. The specific bugs are listed below in the |
| 32 | | -general notes. |
| | 26 | +* ResourceLoader, a new framework for delivering client-side resources such as |
| | 27 | + JavaScript and CSS, has been introduced. These resources are now delivered |
| | 28 | + through the new entry point script "load.php", instead of as static files |
| | 29 | + served directly by the web server. This allows minification, compression and |
| | 30 | + client-side caching to be used more effectively, which should provide a net |
| | 31 | + performance improvement for most users. |
| 33 | 32 | |
| 34 | | -=== New ResourceLoader in 1.17 === |
| 35 | | -MediaWiki 1.17 ships with a ResourceLoader which combines and minifies css and |
| 36 | | -javascript attached to the page. They are served from the new entry point load.php |
| 37 | | -If the page is served with the &debug=true parameter, the non-minified javascript |
| 38 | | -files are used instead. |
| | 33 | +* Category sorting has been improved. |
| | 34 | +** Sorting is now case insensitive. |
| | 35 | +** Sub-categories, pages and files can now be paged separately. |
| | 36 | +** When several pages are given the same sort key, they sort by their |
| | 37 | + names instead of randomly. |
| 39 | 38 | |
| | 39 | +* The lowest supported version of MediaWiki is now 5.2.3. If necessary, please |
| | 40 | + upgrade PHP prior to upgrading MediaWiki. |
| | 41 | + |
| 40 | 42 | === Configuration changes in 1.17 === |
| 41 | 43 | * DatabaseFunctions.php that was needed for compatibility with pre-1.3 |
| 42 | 44 | extensions has been removed. |
| — | — | @@ -715,13 +717,18 @@ |
| 716 | 718 | |
| 717 | 719 | == Compatibility == |
| 718 | 720 | |
| 719 | | -MediaWiki 1.17 requires PHP 5.1 (5.2 recommended). PHP 4 is no longer |
| 720 | | -supported. |
| | 721 | +MediaWiki 1.17 requires PHP 5.2.3 or later. PHP 4 is no longer supported. |
| 721 | 722 | |
| 722 | | -MySQL 3.23.x is no longer supported; some older hosts may need to upgrade. |
| 723 | | -At this time we still recommend 4.0, but 4.1/5.0 will work fine in most cases. |
| | 723 | +MySQL is the recommended DBMS. PostgreSQL or SQLite can also be used, but |
| | 724 | +support for them is somewhat less mature. There is experimental support for IBM |
| | 725 | +DB2, Oracle and Microsoft SQL Server. |
| 724 | 726 | |
| | 727 | +The supported versions are: |
| 725 | 728 | |
| | 729 | +* MySQL 4.0 or later |
| | 730 | +* PostgreSQL 8.3 or later |
| | 731 | +* SQLite 3 |
| | 732 | + |
| 726 | 733 | == Upgrading == |
| 727 | 734 | |
| 728 | 735 | 1.17 has several database changes since 1.16, and will not work without schema |
| — | — | @@ -740,33 +747,20 @@ |
| 741 | 748 | |
| 742 | 749 | See the file UPGRADE for more detailed upgrade instructions. |
| 743 | 750 | |
| 744 | | - |
| 745 | | -=== Caveats === |
| 746 | | - |
| 747 | | -Some output, particularly involving user-supplied inline HTML, may not |
| 748 | | -produce 100% valid or well-formed XHTML output. Testers are welcome to |
| 749 | | -set $wgMimeType = "application/xhtml+xml"; to test for remaining problem |
| 750 | | -cases, but this is not recommended on live sites. (This must be set for |
| 751 | | -MathML to display properly in Mozilla.) |
| 752 | | - |
| 753 | 751 | For notes on 1.16.x and older releases, see HISTORY. |
| 754 | 752 | |
| | 753 | +== Online documentation == |
| 755 | 754 | |
| 756 | | -=== Online documentation === |
| | 755 | +Documentation for both end-users and site administrators is available on |
| | 756 | +MediaWiki.org, and is covered under the GNU Free Documentation License (except |
| | 757 | +for pages that explicitly state that their contents are in the public domain): |
| 757 | 758 | |
| 758 | | -Documentation for both end-users and site administrators is currently being |
| 759 | | -built up on MediaWiki.org, and is covered under the GNU Free Documentation |
| 760 | | -License (except for pages that explicitly state that their contents are in |
| 761 | | -the public domain) : |
| 762 | | - |
| 763 | 759 | http://www.mediawiki.org/wiki/Documentation |
| 764 | 760 | |
| | 761 | +== Mailing list == |
| 765 | 762 | |
| 766 | | -=== Mailing list === |
| | 763 | +A mailing list is available for MediaWiki user support and discussion: |
| 767 | 764 | |
| 768 | | -A MediaWiki-l mailing list has been set up distinct from the Wikipedia |
| 769 | | -wikitech-l list: |
| 770 | | - |
| 771 | 765 | http://lists.wikimedia.org/mailman/listinfo/mediawiki-l |
| 772 | 766 | |
| 773 | 767 | A low-traffic announcements-only list is also available: |
| — | — | @@ -776,7 +770,6 @@ |
| 777 | 771 | It's highly recommended that you sign up for one of these lists if you're |
| 778 | 772 | going to run a public MediaWiki, so you can be notified of security fixes. |
| 779 | 773 | |
| | 774 | +== IRC help == |
| 780 | 775 | |
| 781 | | -=== IRC help === |
| 782 | | - |
| 783 | 776 | There's usually someone online in #mediawiki on irc.freenode.net |