diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2227b1d..f75e263 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,15 @@
 ### 4.0.0 - January 4, 2018
+
+So this library went through a bit of churny phase, my apologies for that. It was caused by a couple
+of factors; moving the library to a new home, a new rendering engine and me trying to abstract said
+rendering engine for reuse in metalsmith-layouts.
+
+However, the end result is now a stable plugin, that's easy to use and easy to maintain.
+Jstransformers are way simpler to debug, and so far I haven't even encountered any bugs. We're not
+abstracting the rendering engine because it's just not worth it, and confusing apis have been
+removed. All in all I hope that you'll enjoy this release and feel free to let me know if you
+encounter anything!
+
 * breaking: dropped node 4 support
 * breaking: the filename property is no longer set automatically, use https://github.com/MoOx/metalsmith-filenames
 * removed metalsmith-engine-jstransformer for ease of maintenance
diff --git a/package-lock.json b/package-lock.json
index 2ca38b5..5c1e0ef 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "metalsmith-in-place",
-  "version": "4.0.0-alpha.2",
+  "version": "4.0.0",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 5a68e4d..c7d5f1e 100644
--- a/package.json
+++ b/package.json
@@ -5,7 +5,7 @@
   "main": "dist/index.js",
   "name": "metalsmith-in-place",
   "repository": "git://github.com/ismay/metalsmith-in-place.git",
-  "version": "4.0.0-alpha.2",
+  "version": "4.0.0",
   "scripts": {
     "prepublishOnly": "babel lib -d dist --ignore '**/*.test.js'",
     "precommit": "lint-staged",