diff --git a/CHANGES.md b/CHANGES.md
index 8aceeef..a6efdc5 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -1,5 +1,5 @@
-## 0.8.0 (2016.07.XX)
+## 0.8.0 (2016.08.18)
Staying on the leading edge of new buzzwords is obviously critical for any framework.
Angular's terrifying faceplant is a sobering reminder to us all.
@@ -46,9 +46,10 @@ Joking aside, this is a substantial release which will change how you use re-fra
https://github.com/Day8/re-frame/blob/master/examples/todomvc/src/todomvc/subs.cljs
- there's now three kinds of event handlers: `-db`, `-fx` and `-ctx`.
- For a tutorial see: https://github.com/Day8/re-frame/wiki/Effectful-Event-Handlers
- XXX Change link to new docs XXX
- For example use see:
+ For a tutorial see: https://github.com/Day8/re-frame/tree/develop/docs
+
+ For examples, see:
+
1. https://github.com/Day8/re-frame-http-fx
2. https://github.com/Day8/re-frame-forward-events-fx
3. https://github.com/Day8/re-frame-async-flow-fx
@@ -58,7 +59,7 @@ Joking aside, this is a substantial release which will change how you use re-fra
Just to be clear: this does not mean you can run re-frame apps on the JVM (there's no React or
Reagent available). But you can debug your event handler tests using full JVM tooling goodness.
- @samroberton and and @escherize have provided the thought leadership and drive here. They converted
+ @samroberton and @escherize have provided the thought leadership and drive here. They converted
re-frame to `.cljc`, supplying plugable interop for both the `js` and `jvm` platforms.
Further, they have worked with @danielcompton to create a library of testing utilities which
@@ -88,27 +89,13 @@ Joking aside, this is a substantial release which will change how you use re-fra
Pedistal's Interceptor pattern which suddenly transformed them from
arcane to delightfully simple in 20 mins. Interceptors are
really "middleware via data" rather than "middleware via higher order functions".
- So it is another way of doing the same thing, but to my mind
- Interceptors are a more flexible platform, and simpler.
+ So it is another way of doing the same thing, but thanks to @steveb8n
+ Interceptors appear a more flexible base, and simpler.
Interceptors also dovetail really nicely with the effects and coeffects
story which has emerged in re-frame through this 0.8.0 release.
- In day to day use, there's a good chance you won't notice the change from
- middleware to Interceptors UNLESS:
-
- 1. You have written your own middleware. If so, you'll have to rewrite it.
- See how [the builtin interceptors are done](https://github.com/Day8/re-frame/blob/develop/src/re_frame/std_interceptors.cljc).
- 2. You explicitly use `comp` like this:
- ```clj
- (reg-event-db
- :some-id
- (comp debug tim-v) ;; <-- change to [debug trim-v]
- (fn [db event]
- ...))
- ```
-
- XXX link to docs
+ Docs: https://github.com/Day8/re-frame/tree/develop/docs
- we now have a logo designed by Sketch Maester @martinklepsch. Thank you Martin! But remember, no
good deed ever goes unpunished - we'll be pestering you every time from now on :-)
@@ -127,9 +114,20 @@ Joking aside, this is a substantial release which will change how you use re-fra
create subscriptions handlers. This release introduced `reg-sub` which becomes the preferred way
to register subscription handlers.
- - middlewares have been replaced by Interceptors. You won't even notice the difference
- unless you have written your own middleware, in which case you'll have to rewrite it
- to be an interceptor. XXX reference to further docs
+ - middlewares have been replaced by Interceptors. In day to day use, there's a good
+ chance you won't notice the change UNLESS:
+
+ 1. You have written your own middleware. If so, you'll have to rewrite it.
+ See how [the builtin interceptors are done](https://github.com/Day8/re-frame/blob/develop/src/re_frame/std_interceptors.cljc).
+
+ 2. You explicitly use `comp` to compose middleware like this:
+ ```clj
+ (reg-event-db
+ :some-id
+ (comp debug tim-v) ;; <-- change to [debug trim-v]
+ (fn [db event]
+ ...))
+ ```
- if you have previously used the undo/redo capabilities buried in re-frame, be aware they have
extracted into a sibling library: https://github.com/Day8/re-frame-undo.