diff --git a/docs/recent-changes.md b/docs/recent-changes.md
new file mode 100644
index 000000000..e51b245cf
--- /dev/null
+++ b/docs/recent-changes.md
@@ -0,0 +1,224 @@
+
+# Release v2.1.0
+
+### Minor Changes
+
+#### [m.censor: work around a bunder bug (@kfule)](https://github.com/MithrilJS/mithril.js/pull/2752)
+
+The internal bundler sometimes mangles the words in RegExp literals incorrectly.  Please see below.
+#### [Warn about reusing mutated attrs object - fixes #2719 (@StephanHoyer)](https://github.com/MithrilJS/mithril.js/pull/2722)
+
+
+#### [Send URLSearchParams as request body without extra configuration (@Coteh)](https://github.com/MithrilJS/mithril.js/pull/2695)
+
+This PR fixes an oddity I noticed in the way `m.request` handles `URLSearchParams` object.  It now handles it in the same sort of way XHR and Fetch do it.
+#### [Add `params:` to `m.route.Link`, fix docs (@dead-claudia)](https://github.com/MithrilJS/mithril.js/pull/2537)
+
+Add `params:` to `m.route.Link`.  Minor fix to docs to reflect reality with `m.route.Link`'s `disabled:` attribute.
+#### [Allow Mithril to be loaded in non-browser environments without modification (@dead-claudia)](https://github.com/MithrilJS/mithril.js/pull/2633)
+
+Recast the global reads to all be guarded with `typeof`, so that if they aren't defined, they're just `null`.
+#### [Add a `m.Fragment = "["` utility for JSX users. (@dead-claudia)](https://github.com/MithrilJS/mithril.js/pull/2744)
+
+The title says it all, and the diff's obvious.  Resolves https://github.com/MithrilJS/mithril.js/issues/2640 and probably others.
+   
+### Patch Changes
+
+#### [Enable --minimize-semver-change for pr-release (@JAForbes)](https://github.com/MithrilJS/mithril.js/pull/2769)
+
+Minimizes semver changes on release to the minimum required version bump to satisfy major/minor/patch semver ranges.  Minimizes the semver change so that.
+#### [Clean up m.route.Link (@barneycarroll)](https://github.com/MithrilJS/mithril.js/pull/2768)
+
+An attempt at better demonstrating `m.route.Link` with less text.  Fixes #2767.
+#### [Runtime-deprecate ospec, change `change-log` to `changelog`, fix a few assorted bugs (@dead-claudia)](https://github.com/MithrilJS/mithril.js/pull/2578)
+
+This PR is in two parts: 1.  Revise the build system and some of the local dev setup.  Fully split ospec from the repo, and add it as a dependency.
+#### [Add meta description to docs (@StephanHoyer)](https://github.com/MithrilJS/mithril.js/pull/2316)
+
+rework of #2149.  added a meta description parser and meta descriptions to all docs pages.  because google.  built the docs, inspected the output manually.
+#### [Fixed badges, consistent naming of Mithril.js (@tbreuss)](https://github.com/MithrilJS/mithril.js/pull/2750)
+
+use consistent naming of Mithril.js.  fix badges in README.  Fixes issue #2749.
+#### [Catch malformed URI Components (@jdiderik)](https://github.com/MithrilJS/mithril.js/pull/2711)
+
+Fix for error thrown when a value contains non-valid / malformed URI Component.  Example: test=%c5%a1%e8ZM%80%82H.  will throw "URI malformed".
+#### [Correctly handle invalid escapes in routes based on 0a5ead31c9fbd7b153c521c7f9d3df7bf826ce6c (@StephanHoyer)](https://github.com/MithrilJS/mithril.js/pull/2743)
+
+fixes #2061.  @dead-claudia I just redid your change but slightly different in order to handle a mix of wrong and right encodings properly.
+#### [Standardise vnode text representation (@barneycarroll)](https://github.com/MithrilJS/mithril.js/pull/2670)
+
+This addresses the crucial feature of #2669: text is always represented as virtual text nodes, never as a `vnode.text`.
+#### [Issue 2624 no content 204 parse (@Evoke-PHP)](https://github.com/MithrilJS/mithril.js/pull/2641)
+
+Added guard so that JSON.parse does not fail on IE11 with no content empty string being parsed.  Fixes https://github.com/MithrilJS/mithril.js/issues/2624.
+#### [[m.request] work around a bundler bug, fix #2647 (@pygy)](https://github.com/MithrilJS/mithril.js/pull/2655)
+
+The bundler mangles identifier-like strings within RegExps, this works around the problem by not using such RegExps.
+#### [Reject request on XHR timeout (@kevinfiol)](https://github.com/MithrilJS/mithril.js/pull/2646)
+
+Derived from PR #2581.  Allows requests to properly reject on event of a timeout.
+#### [Remove extra isLifecycleMethod call from removeAttr (@ZeikJT)](https://github.com/MithrilJS/mithril.js/pull/2594)
+
+Removing an extra isLifecycleMethod in the removeAttr method, it isn't needed since it's already checked on the previous line.
+#### [Fix #2601 (@dead-claudia)](https://github.com/MithrilJS/mithril.js/pull/2603)
+
+Fix issue where ending a stream in the middle of a stream callback would result in erroneous parent stream state for the rest of that emit.  Fixes #2601.
+#### [Add streams to releases again, include minified bundle, drop internal stuff from npm (@dead-claudia)](https://github.com/MithrilJS/mithril.js/pull/2539)
+
+Add `stream/stream.js` to releases again.  Add `stream/stream.min.js` now that the process is remotely sane now.
+#### [Make errors and their messages more accurate and helpful (@dead-claudia)](https://github.com/MithrilJS/mithril.js/pull/2536)
+
+I updated error messages to be much more helpful.
+#### [Fix assertion descriptions (@soulofmischief)](https://github.com/MithrilJS/mithril.js/pull/2405)
+
+I moved the return statement to the end of define() so that it returns even if the comparison fails.
+#### [Fix branch target (@dead-claudia)](https://github.com/MithrilJS/mithril.js/pull/2765)
+
+https://github.com/MithrilJS/mithril.js/runs/6199543939?check_suite_focus=true.
+#### [Automate mithril's release workflow (@JAForbes)](https://github.com/MithrilJS/mithril.js/pull/2760)
+
+Automated releases, pre-releases, (code) rollbacks and recovery, npm publishing, change log management just by using normal github flow.
+#### [rework jsx docs (@StephanHoyer)](https://github.com/MithrilJS/mithril.js/pull/2758)
+
+
+#### [Add Simple Application Flems Supporting v2.0.4 and up (@tbreuss)](https://github.com/MithrilJS/mithril.js/pull/2751)
+
+Added Flems for Simple Application supporting v2.0.4 of Mithril.js.  Fixes Issue #2710.
+#### [Make example work with webpack v5.69.1 (@StephanHoyer)](https://github.com/MithrilJS/mithril.js/pull/2757)
+
+fixes #2634.
+#### [2604: correct and move text about statements in view method (@kevinfiol)](https://github.com/MithrilJS/mithril.js/pull/2748)
+
+Addresses #2604.
+#### [Fix lint errors (@StephanHoyer)](https://github.com/MithrilJS/mithril.js/pull/2745)
+
+
+#### [WIP: Update modularisation details in Installation docs (@orbitbot)](https://github.com/MithrilJS/mithril.js/pull/2620)
+
+added link to flems.io as an easier way to just try out the framework.  -.  Documentation has grown a bit stale.
+#### [Added power support for the travis.yml file with ppc64le (@sreekanth370)](https://github.com/MithrilJS/mithril.js/pull/2644)
+
+Added power support for the travis.yml file with ppc64le.  This is part of the Ubuntu distribution for ppc64le.
+#### [Updated babel/webpack docs to work with latest versions (@pereriksson)](https://github.com/MithrilJS/mithril.js/pull/2649)
+
+As a developer I tried setting up Mithril with Babel and Webpack but failed because of a variety of errors.
+#### [[docs] route redirection using the history API (@pygy)](https://github.com/MithrilJS/mithril.js/pull/1767)
+
+This is an attempt at fixing #1759, but there may be more to be added.  Feedback welcome.  ping @dontwork.
+#### [Bump path-parse from 1.0.6 to 1.0.7 (@dependabot[bot])](https://github.com/MithrilJS/mithril.js/pull/2718)
+
+Bumps [path-parse](https://github.com/jbgutierrez/path-parse) from 1.0.6 to 1.0.7.  Commits.  See full diff in compare view.
+#### [Bump glob-parent from 5.1.0 to 5.1.2 (@dependabot[bot])](https://github.com/MithrilJS/mithril.js/pull/2693)
+
+Bumps [glob-parent](https://github.com/gulpjs/glob-parent) from 5.1.0 to 5.1.2.  Release notes.  Sourced from glob-parent's releases.  v5.1.2.  Bug Fixes.
+#### [Bump ajv from 6.10.2 to 6.12.6 (@dependabot[bot])](https://github.com/MithrilJS/mithril.js/pull/2741)
+
+Bumps [ajv](https://github.com/ajv-validator/ajv) from 6.10.2 to 6.12.6.  Release notes.  Sourced from ajv's releases.  v6.12.6.  Fix performance issue of "url" format.
+#### [Update standalone usage (@ghost)](https://github.com/MithrilJS/mithril.js/pull/2651)
+
+
+#### [Avoid double encoding of function signatures - fixes #2720 (@StephanHoyer)](https://github.com/MithrilJS/mithril.js/pull/2721)
+
+
+#### [Show previous versions (@mike-ward)](https://github.com/MithrilJS/mithril.js/pull/2353)
+
+Add Dropdown that shows links to archived versions of the documentation.
+#### [docs: improve m.request return value description (@GAumala)](https://github.com/MithrilJS/mithril.js/pull/2206)
+
+In the m.request return value description, add a line informing that error status codes cause the promise to reject.
+#### [A note on JSX events (@pereriksson)](https://github.com/MithrilJS/mithril.js/pull/2648)
+
+Naming JSX events according to their documentation produces unexpected results with incorrectly named events when using JSX with Mithril.
+#### [Document route resolution cancellation, fixes #1759 (@barneycarroll)](https://github.com/MithrilJS/mithril.js/pull/2672)
+
+Also fixes a broken internal link.
+#### [Bump marked from 0.7.0 to 4.0.10 (@dependabot[bot])](https://github.com/MithrilJS/mithril.js/pull/2717)
+
+Bumps [marked](https://github.com/markedjs/marked) from 0.7.0 to 4.0.10.  Release notes.  Sourced from marked's releases.  v4.0.10.  4.0.10 (2022-01-13).  Bug Fixes.
+#### [Flems in docs (#2348) [skip ci] (@porsager)](https://github.com/MithrilJS/mithril.js/pull/2348)
+
+Added flems instead of the current codepen samples.
+#### [Remove old TOC link (@ArthurClemens)](https://github.com/MithrilJS/mithril.js/pull/2698)
+
+Content was moved some time ago and linked section no longer exists.
+#### [Cavemansspa patch 1 (@cavemansspa)](https://github.com/MithrilJS/mithril.js/pull/2696)
+
+Documentation update.
+#### [Bump hosted-git-info from 2.8.4 to 2.8.9 (@dependabot[bot])](https://github.com/MithrilJS/mithril.js/pull/2684)
+
+Bumps [hosted-git-info](https://github.com/npm/hosted-git-info) from 2.8.4 to 2.8.9.  Changelog.  Sourced from hosted-git-info's changelog.  2.8.9 (2021-04-07).
+#### [Bump lodash from 4.17.20 to 4.17.21 (@dependabot[bot])](https://github.com/MithrilJS/mithril.js/pull/2680)
+
+Bumps [lodash](https://github.com/lodash/lodash) from 4.17.20 to 4.17.21.  Commits.  f299b52 Bump to v4.17.21.
+#### [Bump handlebars from 4.7.6 to 4.7.7 (@dependabot[bot])](https://github.com/MithrilJS/mithril.js/pull/2679)
+
+Bumps [handlebars](https://github.com/wycats/handlebars.js) from 4.7.6 to 4.7.7.  Changelog.  Sourced from handlebars's changelog.  v4.7.7 - February 15th, 2021.
+#### [Remove unreachable keyed node logic, fixes #2597 (@barneycarroll)](https://github.com/MithrilJS/mithril.js/pull/2673)
+
+
+#### [Delete test-utils/README.md (@dead-claudia)](https://github.com/MithrilJS/mithril.js/pull/2674)
+
+We don't expose this publicly anymore, so there's literally no justification for this file's existence.
+#### [simple-application.md: consistent use of type=submit (@danbst)](https://github.com/MithrilJS/mithril.js/pull/2657)
+
+When following tutorial and typing everything in, I was confused that Save button didn't work.
+#### [Fix inconsistent capitalizations of "JavaScript" (@mtsknn)](https://github.com/MithrilJS/mithril.js/pull/2639)
+
+"Javascript"/"javascript" → "JavaScript".  Fixes #2398, or at least I can't find any more incorrect capitalizations.
+#### [fix some typos (@osban)](https://github.com/MithrilJS/mithril.js/pull/2487)
+
+Found some typos.  Mainly unescaped `|` in tables, but also a few other irregularities.  Not all problems are visible in the website docs.
+#### [Replace mocha by ospec in testing page (@gamtiq)](https://github.com/MithrilJS/mithril.js/pull/2585)
+
+Fixed a typo in testing doc page.  Currently there is reference to `mocha` in the page whereas `opsec` is used.
+#### [Bump acorn from 7.1.0 to 7.4.0 (@dependabot[bot])](https://github.com/MithrilJS/mithril.js/pull/2630)
+
+Bumps [acorn](https://github.com/acornjs/acorn) from 7.1.0 to 7.4.0.  Commits.  54efb62 Mark version 7.4.0.
+#### [Bump handlebars from 4.4.2 to 4.7.6 (@dependabot[bot])](https://github.com/MithrilJS/mithril.js/pull/2629)
+
+Bumps [handlebars](https://github.com/wycats/handlebars.js) from 4.4.2 to 4.7.6.  Changelog.  Sourced from handlebars's changelog.  v4.7.6 - April 3rd, 2020.
+#### [Bump lodash from 4.17.15 to 4.17.20 (@dependabot[bot])](https://github.com/MithrilJS/mithril.js/pull/2628)
+
+Bumps [lodash](https://github.com/lodash/lodash) from 4.17.15 to 4.17.20.  Commits.  ded9bc6 Bump to v4.17.20.  63150ef Documentation fixes.
+#### [Bump minimist from 1.2.0 to 1.2.3 (@dependabot[bot])](https://github.com/MithrilJS/mithril.js/pull/2627)
+
+Bumps [minimist](https://github.com/substack/minimist) from 1.2.0 to 1.2.3.  Commits.  6457d74 1.2.3.  38a4d1c even more aggressive checks for protocol pollution.
+#### [Update installation.md (@purefan)](https://github.com/MithrilJS/mithril.js/pull/2608)
+
+Offer to install mithril as a webpack plugin.  Just makes my life easier by not having to include mithril in every one of my js files.
+#### [replace slave label with replica (@stephanos)](https://github.com/MithrilJS/mithril.js/pull/2605)
+
+One of the example is using the antiquated word "slave" for a database replica.  I updated the language and tested the change.
+#### [ES6 and m.trust docs patch (@kczx3)](https://github.com/MithrilJS/mithril.js/pull/2593)
+
+While reading through some of the documentation I saw some issues with both the ES6 and `m.trust` pages.
+#### [docs: Fix simple typo, subsequece -> subsequence (@timgates42)](https://github.com/MithrilJS/mithril.js/pull/2582)
+
+There is a small typo in mithril.js, render/render.js.  Should read `subsequence` rather than `subsequece`.
+#### [change link to go to ospec instead of mocha (@akessner)](https://github.com/MithrilJS/mithril.js/pull/2576)
+
+Change the link to point to ospec docs in github.  ospec link went to mochajs.  [issue 2575](https://github.com/MithrilJS/mithril.js/issues/2575).  N/A.  N/A.  N/A.
+#### [updated to the Vimeo showcase (@CreaturesInUnitards)](https://github.com/MithrilJS/mithril.js/pull/2573)
+
+The scrimba version of Mithril 0-60 was built on their beta platform, and doesn't really even work anymore.
+#### [adding more community examples (@boazblake)](https://github.com/MithrilJS/mithril.js/pull/2567)
+
+
+#### [Exclude archive of previous docs (@cztomsik)](https://github.com/MithrilJS/mithril.js/pull/2561)
+
+update .npmignore so that archives are not included in the resulting package.  space/bandwidth savings.  fix #2552.
+#### [Pimp the docs linter (and assorted changes) (@pygy)](https://github.com/MithrilJS/mithril.js/pull/2553)
+
+Add an optional cache for faster runs.  Add a final report.  Don't return anything from `exec()`.  Cover more files.  Look for a "--cache" option.
+#### [Recast key docs to be much clearer and more accurate (@dead-claudia)](https://github.com/MithrilJS/mithril.js/pull/2540)
+
+Recast key docs to be much clearer and more accurate, including a few Flems examples to help intuitively explain things.
+#### [Add `m.censor`, adjust `m.route.Link` to use it (@dead-claudia)](https://github.com/MithrilJS/mithril.js/pull/2538)
+
+Add `m.censor`.  Adjust `m.route.Link` to use it.  Restructure a few things for better code reuse.  Fixes #2472.
+#### [Update fetch() browser support in docs (@qgustavor)](https://github.com/MithrilJS/mithril.js/pull/2522)
+
+As [Can I use](https://caniuse.com/#feat=fetch) shows `fetch()` supported since Safari 10.1 and iOS Safari 10.3.
+#### [docs: Add release dates to all change-log files (@maranomynet)](https://github.com/MithrilJS/mithril.js/pull/2513)
+
+I'd like to introduce release dates to the change log files.  Release dates are human-friendly and add a bit of historical perspective to change-log files.
diff --git a/package-lock.json b/package-lock.json
index 635478d58..1f003ed37 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "mithril",
-  "version": "2.0.4",
+  "version": "2.1.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "mithril",
-      "version": "2.0.4",
+      "version": "2.1.0",
       "license": "MIT",
       "dependencies": {
         "ospec": "4.0.0"
diff --git a/package.json b/package.json
index 54a401040..15e42b6d6 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "mithril",
-  "version": "2.0.4",
+  "version": "2.1.0",
   "description": "A framework for building brilliant applications",
   "author": "Leo Horie",
   "license": "MIT",