Ori.livneh has uploaded a new change for review. https://gerrit.wikimedia.org/r/76643
Change subject: Update README w/changes from MediaWiki.org ...................................................................... Update README w/changes from MediaWiki.org This patch contains a re-write of MediaWiki's README. The current README has beeen obsoleted by the passage of time, and its current patchwork of contents is not especially helpful or flattering to MediaWiki. GitHub automatically renders a repository's README below its file listings; GitHub's popularity thus means that this file is a lot more visible than it once was and is more likely to shape a prospective developer's first impression of MediaWiki as a software platform. The re-write was conducted on-wiki, at <https://www.mediawiki.org/wiki/README>, and advertised on wikitech-l. Not much time has passed since the announcement, but even so the updated README is already considerably better, and there's no reason not to continue synchronizing changes from the wiki page on an ongoing basis, so the editorial work on MediaWiki.org need not stop as a consequence of this change being merged. Bug: 50552 Change-Id: Iff7df2567bd90c136ef81fb8dbe7b6d4408be75f --- M README 1 file changed, 26 insertions(+), 115 deletions(-) git pull ssh://gerrit.wikimedia.org:29418/mediawiki/core refs/changes/43/76643/1 diff --git a/README b/README index c9ce5db..7571fc3 100644 --- a/README +++ b/README @@ -1,122 +1,33 @@ -For system requirements, installation and upgrade details, see the files -RELEASE-NOTES, INSTALL, and UPGRADE. - == MediaWiki == -MediaWiki is the software used for Wikipedia [http://www.wikipedia.org/] and the -other Wikimedia Foundation websites. Compared to other wikis, it has an -excellent range of features and support for high-traffic websites using -multiple servers (Wikimedia sites peak in the 100K+ requests per second range -as of January 2012). +MediaWiki is a popular and free, open-source wiki software package written in +PHP. It serves as the platform for Wikipedia and its sister projects, which +deliver content in over 280 languages to more than half a billion people each +month. MediaWiki's reliability and robust feature set have earned it a large +and vibrant community of third-party users and developers. -While quite usable on smaller sites, you may find you have to "roll your own" -local documentation, and some aspects of configuration may seem overcomplicated -because MediaWiki is primarily targeted as an in-house tool. +MediaWiki is: -The MediaWiki software was written by: -* Lee Daniel Crocker -* Magnus Manske -* Jan Hidders -* Brion Vibber -* Axel Boldt -* Geoffrey T. Dairiki -* Tomasz Wegrzanowski -* Erik Moeller -* Tim Starling -* Gabriel Wicke -* Antoine Musso -* Evan Prodromou -* Ævar Arnfjörð Bjarmason -* Niklas Laxström -* Domas Mituzas -* Rob Church -* Jens Frank -* Yuri Astrakhan -* Aryeh Gregor -* Aaron Schulz -* Andrew Garrett -* Raimond Spekking -* Alexandre Emsenhuber -* Siebrand Mazeland -* Chad Horohoe -* Roan Kattouw -* Trevor Pascal -* Bryan Tong Minh -* Sam Reed -* Victor Vasiliev -* Rotem Liss -* Platonides -* Many others (view CREDITS for a more complete list) +* feature-rich and extensible, both on-wiki and with over 2,000 extensions; +* scalable and suitable for both small and large sites; +* available in your language; and +* simple to install, working on most hardware/software combinations. -The contributors hold the copyright to this work, and it is licensed under the -terms of the GNU General Public License, version 2 or later (see -http://www.fsf.org/licensing/licenses/gpl.html). Derivative works and later -versions of the code must be free software licensed under the same or a -compatible license. This includes "extensions" that use MediaWiki functions or -variables; see http://www.gnu.org/licenses/gpl-faq.html#GPLAndPlugins for -details. +For system requirements, installation, and upgrade details, see the files +RELEASE-NOTES, INSTALL, and UPGRADE. -The Wikimedia Foundation currently has no legal rights to the software. +* Ready to get started? + https://www.mediawiki.org/wiki/Download +* Looking for the technical manual? + https://www.mediawiki.org/wiki/Manual:Contents +* Seeking help from a person? + https://www.mediawiki.org/wiki/Communication +* Looking to file a bug report or a feature request? + https://bugs.mediawiki.org/ +* Interested in helping out? + https://www.mediawiki.org/wiki/How_to_contribute -Sections of code written exclusively by Lee Crocker or Erik Moeller are also -released into the public domain, which does not impair the obligations of users -under the GPL for use of the whole code or other sections thereof. - -MediaWiki makes use of the Sajax Toolkit by modernmethod, -http://www.modernmethod.com/sajax/ which has the following license: - - 'This work is licensed under the Creative Commons Attribution - License. To view a copy of this license, visit - http://creativecommons.org/licenses/by/2.0/ or send a letter - to Creative Commons, 559 Nathan Abbott Way, - Stanford, California 94305, USA.' - -MediaWiki use Creative Commons license marks to points to their online -licenses. This content is trademarked and used under a specific license -available at http://creativecommons.org/policies#trademark -The restricted content is: - -* skins/common/images/cc-by-nc-sa.png -* skins/common/images/cc-by-sa.png - -Many thanks to the Wikimedia regulars for testing and suggestions. - -The official website for MediaWiki is located at: - - http://www.mediawiki.org/ - -The code is currently maintained in a Git repository at -gerrit.wikimedia.org. See http://www.mediawiki.org/wiki/Git for details. - -Please report bugs and make feature requests in our Bugzilla system: - -* https://bugzilla.wikimedia.org/ - -Documentation and discussion on new features may be found at: - -* http://www.mediawiki.org/wiki/Manual:FAQ -* http://www.mediawiki.org/wiki/Documentation -* http://www.mediawiki.org/wiki/Development - -Extensions are listed at: - -* http://www.mediawiki.org/wiki/Category:Extensions - -If you are setting up your own wiki based on this software, it is highly -recommended that you subscribe to mediawiki-announce: - -* https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce - -The mailing list is very low volume, and is intended primarily for announcements -of new versions, bug fixes, and security issues. - -A higher volume support mailing list can be found at: - -* https://lists.wikimedia.org/mailman/listinfo/mediawiki-l - -Developer discussion takes place at: - -* https://lists.wikimedia.org/mailman/listinfo/wikitech-l - -There is also a development and support channel #mediawiki on irc.freenode.net, -and an unoffical support forum at www.mwusers.com. +MediaWiki is the result of global collaboration and cooperation. The CREDITS +file lists technical contributors to the project. The COPYING file explains +MediaWiki's copyright and license (GNU General Public License, version 2 or +later). Many thanks to the Wikimedia regulars for testing and suggestions. -- To view, visit https://gerrit.wikimedia.org/r/76643 To unsubscribe, visit https://gerrit.wikimedia.org/r/settings Gerrit-MessageType: newchange Gerrit-Change-Id: Iff7df2567bd90c136ef81fb8dbe7b6d4408be75f Gerrit-PatchSet: 1 Gerrit-Project: mediawiki/core Gerrit-Branch: master Gerrit-Owner: Ori.livneh <[email protected]> _______________________________________________ MediaWiki-commits mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits
