This file is parsed in the web installer, which doesn't
understand markdown - it uses the MediaWiki parser.
This reverts commit c0342da8e9.
Bug: T196607
Change-Id: If35f0212dafa80afe59c019ab25b875cd0977fc8
The only wikitext-speficic syntax in here is the title.
Renaming this to Markdown has various benefits:
* Makes the README render properly on Gitiles, Doxygen, and Diffusion.
The current README is not renderable in Gitiles or Doxygen.
* More familiar to new contributors in open-source.
* Consistent with other documentation content we maintain within Git,
including all PHP and JS documentation, which via JSDoc/JSDuck/Doxygen
have all their descriptions parsed in Markdown.
* Rich previews and syntax highlighting in many text editors
and Git viewers.
Change-Id: I5bade76528fa3d870334d960c39db009644bb58f
The link is intentional as that is the canonical location
of where bugs should be filed, and is independent of any
future software change.
Finally, changes to the README should be drafted on-wiki first
at [[mw:README]].
This reverts commit af9258794c.
Change-Id: Ie453cee5218261cba4f6e18d13c4089c23ff2166
Update README to version from
<https://www.mediawiki.org/w/index.php?title=README&oldid=1305801> which
was updated to include changes made in git through commit cbc3289.
The bug tracker link change from 811b2e6 was deliberately omitted from
the on wiki updates as bugzilla.wikimedia.org is now a redirect to
phabricator.wikimedia.org in the same way that bugs.mediawiki.org is and
advertising the particular bug tracking software used by the project in
the README seems unnecessary.
Change-Id: Ia73cc6c2b80e85c47a3023b7aef19a5b54aa47cf
This change largely reverts commit 5ab2d62a73.
The exception being the change from "regulars" to "community".
Change-Id: I28081364fae5de6ea5bcd07dc135251610e6b7d9
This reverts commit 9a497dd3c9, which added an additional blank line to
the README in an attempt to work around a bug in GitHub's wikitext
renderer which causes it to swallow any whitespace that follows a bulleted
list. It didn't fix the issue (it's now simply swallowing two lines rather
than one).
Change-Id: I4312d783eea5585f5c3e3b895ab2c78a170b682d
Add an extra line of whitespace between the final bullet-point item and
the paragraph that proceeds it.
Change-Id: I10d7abf86d630da4970a1d7b3e103cff4e83e691
This patch contains a re-write of MediaWiki's README. The current README has
been 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.
This patch also includes an update to COPYING, incorporating legal text that
has been removed from the README, and adding some more information about
licensing. These changes include:
- changed URL from GPL (unspecified version, pointing currently to v3)
to GPL v2, to match the text
- removed statement that the Foundation does not hold any rights in
the codebase, as it may in some cases have rights through
contractors
- added note about looking for information in individual components
- removed incorrect CC information about Sajax (which appears to be
BSD-licensed, according to its file header in skins/common/ajax.js
- rephrased the CC license information to make more clear and precise
Bug: 50552
Change-Id: Iff7df2567bd90c136ef81fb8dbe7b6d4408be75f
* Removed the specialised getFileContents() functions, they are unnecessary now that I have reformatted COPYING into wikitext.
In WebInstaller_Document::formatTextFile():
* Introduced new tab-indented syntax, which is equivalent to colon indents in ordinary wikitext. This was useful for reformatting the GPL.
* Removed the special case for spaces preceding URLs, used tabs instead, with the above feature.
* Removed the "numbers in square brackets" feature. The place where this was used, in README, was an unfortunate case where the square brackets originally indicated a footnote and its reference. Then another two "footnotes" were added with no corresponding reference, they just talked about random license-related stuff that happened to be similar to the footnote. It was never actually meant to be a numbered list. Fixed in README.
* Convert from DOS line endings to UNIX early on, to simplify the regexes.
* fixed urls
* end lines at 80 chars
* updated Wikimedia traffic
* updated the list of authors to be the same as the one at Special:Version
* modified the note telling that extensions must be under GPL. Per http://www.gnu.org/licenses/gpl-faq.html#GPLAndPlugins, they can also be under a compatible license
* Under the GPL-2 => Under the GPL-2 or later
* Made a note of the fact that extensions which use the MediaWiki code also have to be under the same license terms as the main code
* Copyright may be assigned to the foundation at a later date => [...] at a later date by individual contributors
