diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 7095ddaa..e35c53be 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,7 +1,14 @@
 ## Pre-requisites
 
 The project uses [Leiningen 2](https://leiningen.org) and requires ElasticSearch `1.4.x` or more recent to be running
-locally. Make
+locally.
+
+`script.disable_dynamic` must be `false` for all tests to pass. To set this, add the following to your `elasticsearch.yml` file:
+
+    script:
+        disable_dynamic: false
+
+Make
 sure you have those two installed and then run tests against all supported Clojure versions using
 
     lein all test
@@ -9,4 +16,7 @@ sure you have those two installed and then run tests against all supported Cloju
 ## Pull Requests
 
 Then create a branch and make your changes on it. Once you are done with your changes and all
-tests pass, write a [good, detailed commit message](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) submit a pull request on GitHub.
+tests pass, write a [good, detailed commit message](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) and submit a pull request on GitHub.
+
+Don't forget to add your changes to `ChangeLog.md` and credit yourself!
+
diff --git a/ChangeLog.md b/ChangeLog.md
index a84108a1..f35e531c 100644
--- a/ChangeLog.md
+++ b/ChangeLog.md
@@ -8,6 +8,13 @@ Elastisch now depends on ElasticSearch Java client version `1.5.x`.
 
 [clj-http](https://github.com/dakrone/clj-http/) dependency has been upgraded to version `1.1.0`.
 
+### Better support for plural/single indices and aliases in native update-aliases
+
+* `:remove` action now works with singular `:index` key 
+* multiple aliases can be added with single `:add` action
+* alias can be removed from multiple indices with single `:remove` action
+
+Contributed by @mnylen
 
 ## Changes between Elastisch 2.2.0-beta2 and 2.2.0-beta3