MediaWiki-Vendor ================ [Composer] managed libraries required or recommended for use with [MediaWiki]. This repository is maintained for use on the Wikimedia Foundation production and testing clusters, but may be useful for anyone wishing to avoid directly managing MediaWiki dependencies with Composer. Usage ----- Checkout this library into $IP/vendor using `git clone ` or add the repository as a git submodule using `git submodule add vendor` followed by `git submodule update --init`. Adding or updating libraries ---------------------------- 0. Read the [documentation] on the process for adding new libraries. 1. Ensure you're using version 1.6.2 (or later. This keeps installed.json alphasorted, making patches less likely to conflict, and diffs easier to read) of composer via `composer --version`. 2. Edit the composer.json file to add/update the libraries you want to change. 3. Run `composer update --no-dev --ignore-platform-reqs` to download files and update the autoloader. 4. Add all the new dependencies that got installed to composer.json as well, so that everything has their version pinned. (You can look at the changes in composer.lock or composer/installed.json to see what they are.) 5. Add and commit changes as a gerrit patch. 6. Review and merge changes. [Composer]: https://getcomposer.org/ [MediaWiki]: https://www.mediawiki.org/wiki/MediaWiki [documentation]: https://www.mediawiki.org/wiki/Manual:External_libraries