diff --git a/CHANGELOG.md b/CHANGELOG.md
index 01caa41..57b70f8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 > This project uses [Break Versioning](https://github.com/ptaoussanis/encore/blob/master/BREAK-VERSIONING.md) as of **Aug 16, 2014**.
 
+## v4.7.0 / 2016 Jul 19
+
+```clojure
+[com.taoensso/timbre "4.7.0"]
+```
+
+* **New**: [#183] Add support for appender-level middleware
+
 ## v4.6.0 / 2016 Jul 12
 
 ```clojure
diff --git a/README.md b/README.md
index e23cd71..867bf05 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
 **[CHANGELOG]** | [API] | current [Break Version]:
 
 ```clojure
-[com.taoensso/timbre "4.6.0"] ; Stable
+[com.taoensso/timbre "4.7.0"] ; Stable
 ```
 
 > Please consider helping to [support my continued open-source Clojure/Script work]? 
@@ -51,7 +51,7 @@ Your link here?          | **PR's welcome!**
 Add the necessary dependency to your project:
 
 ```clojure
-[com.taoensso/timbre "4.6.0"]
+[com.taoensso/timbre "4.7.0"]
 ```
 
 And setup your namespace imports:
@@ -113,9 +113,19 @@ ANSI colors are enabled by default for stacktraces. To turn these off (e.g. for
 
 And/or you can set the `TIMBRE_DEFAULT_STACKTRACE_FONTS` environment variable (supports edn).
 
+### Data flow
+
+Timbre's inherently a very simple design, no magic. It's just Clojure data and functions:
+
+ 1. Unfiltered logging calls generate a **data map**: `{:level _ :?ns-str _ ...}`
+ 2. The resulting data map passes through any **middleware fns**, `(fn [data]) -> ?data`
+ 3. The resulting data map is sent to all **appender fns**, `(fn [data]) -> ?effects`
+
 ### Configuration
 
-This is the biggest win over Java logging IMO. **All** of Timbre's behaviour is controlled through a single, simple Clojure map.
+This is the biggest win over Java logging IMO. 
+
+**All** of Timbre's behaviour is controlled through a single, simple Clojure map.
 
 > See `timbre/example-config` for Timbre's default config map
 
diff --git a/project.clj b/project.clj
index b8dc4ce..26f6c75 100644
--- a/project.clj
+++ b/project.clj
@@ -1,4 +1,4 @@
-(defproject com.taoensso/timbre "4.6.0"
+(defproject com.taoensso/timbre "4.7.0"
   :author "Peter Taoussanis <https://www.taoensso.com>"
   :description "Pure Clojure/Script logging library"
   :url "https://github.com/ptaoussanis/timbre"
@@ -13,7 +13,7 @@
   :dependencies
   [[org.clojure/clojure "1.5.1"]
    [com.taoensso/encore "2.64.1"]
-   [io.aviso/pretty     "0.1.27"]]
+   [io.aviso/pretty     "0.1.28"]]
 
   :plugins
   [[lein-pprint  "1.1.2"]
@@ -27,7 +27,7 @@
    :1.6  {:dependencies [[org.clojure/clojure "1.6.0"]]}
    :1.7  {:dependencies [[org.clojure/clojure "1.7.0"]]}
    :1.8  {:dependencies [[org.clojure/clojure "1.8.0"]]}
-   :1.9  {:dependencies [[org.clojure/clojure "1.9.0-alpha9"]]}
+   :1.9  {:dependencies [[org.clojure/clojure "1.9.0-alpha10"]]}
    :test
    {:dependencies
     [[org.clojure/tools.logging "0.3.1"]