diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9683299c..20c80e0b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,13 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html), enforced with [semantic-release](https://github.com/semantic-release/semantic-release).
 
+## [2.2.1](https://github.com/thibaudcolas/draftjs-filters/compare/v2.2.0...v2.2.1) (2019-01-23)
+
+### Bug Fixes
+
+- **api:** auto-generate documentation using flow types. Fix [#19](https://github.com/thibaudcolas/draftjs-filters/issues/19) ([#26](https://github.com/thibaudcolas/draftjs-filters/issues/26)) ([a2da323](https://github.com/thibaudcolas/draftjs-filters/commit/a2da323))
+- **api:** auto-update API docs in README ([aa40707](https://github.com/thibaudcolas/draftjs-filters/commit/aa40707))
+
 # [2.2.0](https://github.com/thibaudcolas/draftjs-filters/compare/v2.1.0...v2.2.0) (2019-01-22)
 
 ### Bug Fixes
diff --git a/README.md b/README.md
index c1edda40..4fe3bccd 100644
--- a/README.md
+++ b/README.md
@@ -110,6 +110,7 @@ injects on arbitrary blocks on paste.
 ##### resetAtomicBlocks
 
 Resets atomic blocks to have a single-space char and no styles.
+This is how they are stored by Draft.js by default.
 
 ###### Parameters
 
@@ -227,6 +228,8 @@ Filters entities based on the data they contain.
 ##### filterEntityData
 
 Filters data on an entity to only retain what is whitelisted.
+This is crucial for IMAGE and LINK, where Draft.js adds a lot
+of unneeded attributes (width, height, etc).
 
 ###### Parameters
 
@@ -258,6 +261,7 @@ See <https://github.com/thibaudcolas/draftjs-filters/issues/27>.
 
 Applies whitelist and blacklist operations to the editor content,
 to enforce it's shaped according to the options.
+Will not alter the editor state if there are no changes to make.
 
 ###### Parameters
 
diff --git a/package-lock.json b/package-lock.json
index 830b7102..5b9d40b1 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "draftjs-filters",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
@@ -8567,12 +8567,14 @@
         "balanced-match": {
           "version": "1.0.0",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "brace-expansion": {
           "version": "1.1.11",
           "bundled": true,
           "dev": true,
+          "optional": true,
           "requires": {
             "balanced-match": "^1.0.0",
             "concat-map": "0.0.1"
@@ -8587,17 +8589,20 @@
         "code-point-at": {
           "version": "1.1.0",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "concat-map": {
           "version": "0.0.1",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "console-control-strings": {
           "version": "1.1.0",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "core-util-is": {
           "version": "1.0.2",
@@ -8714,7 +8719,8 @@
         "inherits": {
           "version": "2.0.3",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "ini": {
           "version": "1.3.5",
@@ -8726,6 +8732,7 @@
           "version": "1.0.0",
           "bundled": true,
           "dev": true,
+          "optional": true,
           "requires": {
             "number-is-nan": "^1.0.0"
           }
@@ -8740,6 +8747,7 @@
           "version": "3.0.4",
           "bundled": true,
           "dev": true,
+          "optional": true,
           "requires": {
             "brace-expansion": "^1.1.7"
           }
@@ -8747,12 +8755,14 @@
         "minimist": {
           "version": "0.0.8",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "minipass": {
           "version": "2.2.4",
           "bundled": true,
           "dev": true,
+          "optional": true,
           "requires": {
             "safe-buffer": "^5.1.1",
             "yallist": "^3.0.0"
@@ -8771,6 +8781,7 @@
           "version": "0.5.1",
           "bundled": true,
           "dev": true,
+          "optional": true,
           "requires": {
             "minimist": "0.0.8"
           }
@@ -8851,7 +8862,8 @@
         "number-is-nan": {
           "version": "1.0.1",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "object-assign": {
           "version": "4.1.1",
@@ -8863,6 +8875,7 @@
           "version": "1.4.0",
           "bundled": true,
           "dev": true,
+          "optional": true,
           "requires": {
             "wrappy": "1"
           }
@@ -8984,6 +8997,7 @@
           "version": "1.0.2",
           "bundled": true,
           "dev": true,
+          "optional": true,
           "requires": {
             "code-point-at": "^1.0.0",
             "is-fullwidth-code-point": "^1.0.0",
diff --git a/package.json b/package.json
index 082bce0b..c62ea311 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "draftjs-filters",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "Filter Draft.js content to preserve only the formatting you allow",
   "author": "Thibaud Colas",
   "license": "MIT",