Docs WIP

CHANGES.md

@@ -1,6 +1,6 @@
-## 0.9.0 (2016.12.15)
+## 0.9.0 (2016.12.15) - The Dolores Release
 
-Welcome, Guests. Dr Ford has created a new [6-part narrative](README.md), 
+Welcome, board members.  Dr Ford has created a new [6-part narrative](README.md), 
 and Bernard [some infographics](/docs/EventHandlingInfographic.md). Anyone seen Dolores?
 
 #### Headline
@@ -31,7 +31,7 @@ and Bernard [some infographics](/docs/EventHandlingInfographic.md). Anyone seen
 - [#248](https://github.com/Day8/re-frame/pull/248) Provide after interceptor with `db` coeffect, if no `db` effect was produced.
 - [#278](https://github.com/Day8/re-frame/issues/278) Provide enrich interceptor with `db` coeffect, if no `db` effect was produced.
 
-## 0.8.0  (2016.08.19)
+## 0.8.0  (2016.08.19) - The Walnuts Release
 
 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. 

README.md

@@ -30,16 +30,16 @@ Perhaps:
     **completely change everything**?  And, if so, what would that look like in a language
     that embraces those paradigms?
 3.  You're taking a [Functional Design and Programming course](http://www.eli.sdsu.edu/courses/fall15/cs696/index.html) at San Diego State University
-    and you have a re-frame/reagent assignment due.  You've left the reading a bit late, right? I remember those days.
+    and you have a re-frame/reagent assignment due.  You've left the reading a bit late, right?
-4.  You know Redux, Elm, cycle.js or pux and you're
+4.  You know Redux, Elm, Cycle.js or Pux and you're
     interested in a ClojureScript implementation, **with a data oriented design**.
     In this space, re-frame is very old, hopefully in a Gandalf kind of way.
     First designed in Dec 2014, it even slightly pre-dates the official Elm Architecture,
     although thankfully we were influenced by early-Elm concepts like `foldp` and `lift`, as well as 
-    terrific Clojure projects like [Pedestal App], [Om] and [Hoplon]. Since then,  
+    terrific Clojure projects like [Pedestal App], [Om] and [Hoplon]. Since then,
     re-frame has pioneered ideas like event handler middleware,
     coeffect accretion, and de-duplicated signal graphs.
-5.  Which brings us to the most important point: re-frame is impressively buzzword compliant. It has reactivity,
+5.  Which is a lovely segue into the most important point: **re-frame is impressively buzzword compliant**. It has reactivity,
     unidirectional data flow, pristinely pure functions,
     interceptors, coeffects, conveyor belts, statechart-friendliness (FSM)
     and claims an immaculate hammock conception. It also has a charming
@@ -101,10 +101,10 @@ Computationally, each iteration of the loop involves a
 six domino cascade.
 
 One domino triggers the next, which triggers the next, et cetera, until we are 
-back at the beginning of the loop, whereupon the dominoes all spring to attention 
+back at the beginning of the loop, whereupon the dominoes spring to attention 
 again, ready for the next iteration of the same cascade.
 
-Here are the six dominoes ...
+The six dominoes are ...
 
 ### 1st Domino - Event Dispatch
 

docs/ApplicationState.md

@@ -1,19 +1,5 @@
 ## Application State
 
-
-#### Table Of Contents
-
-<!-- START doctoc generated TOC please keep comment here to allow auto update -->
-<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
-
-- [On Data](#on-data)
-- [The Big Ratom](#the-big-ratom)
-- [The Benefits Of Data-In-The-One-Place](#the-benefits-of-data-in-the-one-place)
-
-<!-- END doctoc generated TOC please keep comment here to allow auto update -->
-
-### On Data
-
 <blockquote class="twitter-tweet" lang="en"><p>Well-formed Data at rest is as close to perfection in programming as it gets. All the crap that had to happen to put it there however...</p>&mdash; Fogus (@fogus) <a href="https://twitter.com/fogus/status/454582953067438080">April 11, 2014</a></blockquote>
 <script async src="//platform.twitter.com/widgets.js" charset="utf-8"></script>
 
@@ -132,3 +118,9 @@ See FAQ #1
 Previous:  [This Repo's README](../README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 Up:  [Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 Next:  [First Code Walk-Through](CodeWalkthrough.md)
+
+
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->