PHPackages wikimedia/update-history - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. wikimedia/update-history ActiveLibrary wikimedia/update-history ======================== A simple tool to update HISTORY.md files 1.0.3(5mo ago)19.7k↑125%12MITPHPPHP >=7.4.0 Since Aug 6Pushed 2mo ago19 watchersCompare [ Source](https://github.com/wikimedia/mediawiki-libs-UpdateHistory)[ Packagist](https://packagist.org/packages/wikimedia/update-history)[ Docs](https://www.mediawiki.org/wiki/UpdateHistory)[ RSS](/packages/wikimedia-update-history/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (7)Versions (4)Used By (12) [![Latest Stable Version](https://camo.githubusercontent.com/ed88583a1e81884e10859bff4b5528b5c61d4679d147436fbeefc5fca55c97db/68747470733a2f2f706f7365722e707567782e6f72672f77696b696d656469612f7570646174652d686973746f72792f762f737461626c652e737667)](https://packagist.org/packages/wikimedia/update-history) [![License](https://camo.githubusercontent.com/520ba1b78c7007b4a8934a694d9b9f5087593df63bf214dd214da7852979dc9e/68747470733a2f2f706f7365722e707567782e6f72672f77696b696d656469612f7570646174652d686973746f72792f6c6963656e73652e737667)](https://packagist.org/packages/wikimedia/update-history) wikimedia/update-history ======================== [](#wikimediaupdate-history) A simple tool to update HISTORY.md files when making a library release. Additional documentation about this library can be found on [mediawiki.org](https://www.mediawiki.org/wiki/UpdateHistory). Usage ----- [](#usage) To make a release: Step 1 ------ [](#step-1) ``` bin/update-history [patch|minor|major] ``` This increments the version number for a patch release (or, if you specify, for a minor or major release instead) and updates the HISTORY.md with the new version number and the current date. Step 2 ------ [](#step-2) ``` git add HISTORY.md git commit -m "Release " git tag ``` This step will be automated in the future. Step 3 ------ [](#step-3) ``` bin/update-history ``` This adds a new placeholder "x.x.x (not yet released)" section to the HISTORY.md. Step 4 ------ [](#step-4) ``` git add HISTORY.md git commit -m "Bump HISTORY.md after release" ``` This step will be automated in the future. Step 5 (optional) ----------------- [](#step-5-optional) Push these commits to your code review system. ``` git review ``` When they are merged you may have to verify that the tag created above still corresponds to the final merged commit, and if not: ``` git tag -f ``` And finally, push the new tag: ``` git push origin ``` To add this tool to a new PHP project ------------------------------------- [](#to-add-this-tool-to-a-new-php-project) Add this as a dependency: ``` composer require --dev --fixed wikimedia/update-history ``` It's recommended to add a shortcut to the `"scripts"` section of your `composer.json` for the most common release action: ``` { ... "scripts": { ... "update-history": "update-history patch", } } ``` We also recommend adding a section to your `README.md` documenting the use of this tool: ``` Releasing a new version ----------------------- This package uses `wikimedia/update-history` and its conventions. See https://www.mediawiki.org/wiki/UpdateHistory for details. ``` --- ### Health Score 48 — FairBetter than 95% of packages Maintenance80 Actively maintained with recent releases Popularity26 Limited adoption so far Community28 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~791 days Total 3 Last Release 164d ago PHP version history (2 changes)1.0.0PHP >=7.2.9 1.0.3PHP >=7.4.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/b94d9718c06ec7c3fd7a104bc44966fb7464b9ec7411582343ea35a7a6a85f08?d=identicon)[mediawiki](/maintainers/mediawiki) ![](https://www.gravatar.com/avatar/716c86d71cbf921e7912a505f89d799de398fc0a3af0bd4c8862834b2d642bd7?d=identicon)[wikimedia](/maintainers/wikimedia) ![](https://www.gravatar.com/avatar/3551c2aefb299a0c45807f7677f5b26d8a5be4a4af359b4bf4fabbdd1f2b990e?d=identicon)[cscott](/maintainers/cscott) --- Top Contributors [![cscott](https://avatars.githubusercontent.com/u/156080?v=4)](https://github.com/cscott "cscott (14 commits)")[![reedy](https://avatars.githubusercontent.com/u/67615?v=4)](https://github.com/reedy "reedy (8 commits)")[![supertassu](https://avatars.githubusercontent.com/u/9721638?v=4)](https://github.com/supertassu "supertassu (3 commits)")[![jdforrester](https://avatars.githubusercontent.com/u/881572?v=4)](https://github.com/jdforrester "jdforrester (2 commits)")[![umherirrender](https://avatars.githubusercontent.com/u/1174884?v=4)](https://github.com/umherirrender "umherirrender (2 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/wikimedia-update-history/health.svg) ``` [![Health](https://phpackages.com/badges/wikimedia-update-history/health.svg)](https://phpackages.com/packages/wikimedia-update-history) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)