From d4f51f933b9ce21e752314e02babedb37fe47e00 Mon Sep 17 00:00:00 2001
From: Shaun Mahood <smahodo@Shauns-Air.lan>
Date: Sun, 28 Aug 2016 09:40:00 -0600
Subject: [PATCH 01/12] Docs navigation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add navigation to bottom of docs that don’t have it, update existing to
match current doc structure
---
 docs/Basic-App-Structure.md  | 5 +++++
 docs/Effects.md              | 5 +++++
 docs/Interceptors.md         | 5 +++++
 docs/Loading-Initial-Data.md | 2 +-
 docs/Namespaced-Keywords.md  | 5 +++++
 docs/Navigation.md           | 8 +++++++-
 docs/Talking-To-Servers.md   | 4 ++++
 docs/coeffects.md            | 4 ++++
 8 files changed, 36 insertions(+), 2 deletions(-)

diff --git a/docs/Basic-App-Structure.md b/docs/Basic-App-Structure.md
index 42267add9..50ce1f850 100644
--- a/docs/Basic-App-Structure.md
+++ b/docs/Basic-App-Structure.md
@@ -57,3 +57,8 @@ src
 ```
 
 Continue to [Navigation](Navigation.md) to learn how to switch between panels of a larger app.
+
+---
+Previous:  [CoEffects](coeffects.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Next:  [Navigation](navigation.md)  
diff --git a/docs/Effects.md b/docs/Effects.md
index 42daf7fef..917428385 100644
--- a/docs/Effects.md
+++ b/docs/Effects.md
@@ -355,3 +355,8 @@ usage:
 Create a PR to include yours in this list. 
 
 XXX maybe put this list into the Wiki, so editable by all. 
+
+---
+Previous:  [Interceptors](Interceptors.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Next:  [CoEffects](coeffects.md)  
diff --git a/docs/Interceptors.md b/docs/Interceptors.md
index 68e27199c..78bde7695 100644
--- a/docs/Interceptors.md
+++ b/docs/Interceptors.md
@@ -380,3 +380,8 @@ To use them, first require them:
   (:require
     [re-frame.core :refer [debug path]])
 ```
+
+---
+Previous:  [Effectful Handlers](EffectfulHandlers.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Next:  [Effects](Effects.md)  
diff --git a/docs/Loading-Initial-Data.md b/docs/Loading-Initial-Data.md
index cb0449942..d1059eb5a 100644
--- a/docs/Loading-Initial-Data.md
+++ b/docs/Loading-Initial-Data.md
@@ -216,7 +216,7 @@ The next Tutorial will show you how.
 
 
 ---
-Previous:  [Interceptors](Interceptors.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Previous:  [Namespaced Keywords](Namespaced-Keywords.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 Next:  [Talking To Servers](Talking-To-Servers.md)  
 
diff --git a/docs/Namespaced-Keywords.md b/docs/Namespaced-Keywords.md
index f2b9ae693..6fe019f6b 100644
--- a/docs/Namespaced-Keywords.md
+++ b/docs/Namespaced-Keywords.md
@@ -19,3 +19,8 @@ fiction. I can have the keyword `:panel1/edit` even though
 
 Naturally, you'll take advantage of this by using keyword namespaces 
 which are both unique and descriptive.
+
+---
+Previous:  [Navigation](Navigation.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Next:  [Loading Initial Data](Loading-Initial-Data.md)  
\ No newline at end of file
diff --git a/docs/Navigation.md b/docs/Navigation.md
index 04091f488..89530239e 100644
--- a/docs/Navigation.md
+++ b/docs/Navigation.md
@@ -19,6 +19,7 @@ When the user does something navigation-ish (selects a tab, a dropdown or someth
 ```
 
 A high level reagent view has a subscription to :active-panel and will switch to the associated panel.
+
 ```clj
 (re-frame/reg-sub
   :active-panel
@@ -43,7 +44,12 @@ A high level reagent view has a subscription to :active-panel and will switch to
        (condp = @active                ;; or you could look up in a map
          :panel1   [panel1]
          :panel2   [panel2])])))
-
 ```
 
+
 Continue to [Namespaced Keywords](Namespaced-Keywords.md) to reduce clashes on ids.
+
+---
+Previous:  [Navigation](Navigation.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Next:  [Namespaced Keywords](Namespaced-Keywords.md)
diff --git a/docs/Talking-To-Servers.md b/docs/Talking-To-Servers.md
index f4aa0862e..07410cfe8 100644
--- a/docs/Talking-To-Servers.md
+++ b/docs/Talking-To-Servers.md
@@ -113,6 +113,7 @@ In the 2nd version, we use the alternative registration function, `reg-event-fx`
 You may soon feel confident enough to write your own.
  
 Here's our rewrite:
+
 ```clj
 (ns my.app.events                  
    (:require
@@ -138,3 +139,6 @@ Notes:
   
   
   
+---
+Previous:  [Talking To Servers](Talking-To-Servers.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
diff --git a/docs/coeffects.md b/docs/coeffects.md
index 296c8bb56..f9c56a827 100644
--- a/docs/coeffects.md
+++ b/docs/coeffects.md
@@ -267,3 +267,7 @@ In note form:
   5. We must have previously registered a cofx handler via `reg-cofx`
   
    
+---
+Previous:  [Effects](Effects.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Next:  [Basic App Structure](Basic-App-Structure.md)  

From ed19f36376859bd2e81fa360b85fdd894b495a45 Mon Sep 17 00:00:00 2001
From: Shaun Mahood <smahodo@Shauns-Air.lan>
Date: Sun, 28 Aug 2016 09:41:52 -0600
Subject: [PATCH 02/12] Fix typo

---
 docs/Basic-App-Structure.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/Basic-App-Structure.md b/docs/Basic-App-Structure.md
index 50ce1f850..30dd48c0d 100644
--- a/docs/Basic-App-Structure.md
+++ b/docs/Basic-App-Structure.md
@@ -61,4 +61,4 @@ Continue to [Navigation](Navigation.md) to learn how to switch between panels of
 ---
 Previous:  [CoEffects](coeffects.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-Next:  [Navigation](navigation.md)  
+Next:  [Navigation](Navigation.md)  

From 2ebff403731f73bcf709a2047f8e921e01519ecf Mon Sep 17 00:00:00 2001
From: Shaun Mahood <smahodo@Shauns-Air.lan>
Date: Sun, 28 Aug 2016 09:50:15 -0600
Subject: [PATCH 03/12] Docs Navigation

Fix links to Index and wrong navigation links
---
 docs/Basic-App-Structure.md          | 2 +-
 docs/EffectfulHandlers.md            | 2 +-
 docs/Effects.md                      | 2 +-
 docs/Interceptors.md                 | 2 +-
 docs/Loading-Initial-Data.md         | 2 +-
 docs/Namespaced-Keywords.md          | 2 +-
 docs/Navigation.md                   | 2 +-
 docs/Subscribing-To-External-Data.md | 3 +++
 docs/Talking-To-Servers.md           | 5 +++--
 docs/coeffects.md                    | 2 +-
 10 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/docs/Basic-App-Structure.md b/docs/Basic-App-Structure.md
index 30dd48c0d..3749b52d1 100644
--- a/docs/Basic-App-Structure.md
+++ b/docs/Basic-App-Structure.md
@@ -60,5 +60,5 @@ Continue to [Navigation](Navigation.md) to learn how to switch between panels of
 
 ---
 Previous:  [CoEffects](coeffects.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 Next:  [Navigation](Navigation.md)  
diff --git a/docs/EffectfulHandlers.md b/docs/EffectfulHandlers.md
index d1cf830fe..5fc2bd456 100644
--- a/docs/EffectfulHandlers.md
+++ b/docs/EffectfulHandlers.md
@@ -393,6 +393,6 @@ the mechanism by which  event handlers are executed. That knowledge will give us
 to then, as a next step, better understand coeffects and effects. We'll soon be writing our own.   
 
 ---
-Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 Next:  [Interceptors](Interceptors.md)  
 
diff --git a/docs/Effects.md b/docs/Effects.md
index 917428385..1929b97f3 100644
--- a/docs/Effects.md
+++ b/docs/Effects.md
@@ -358,5 +358,5 @@ XXX maybe put this list into the Wiki, so editable by all.
 
 ---
 Previous:  [Interceptors](Interceptors.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 Next:  [CoEffects](coeffects.md)  
diff --git a/docs/Interceptors.md b/docs/Interceptors.md
index 78bde7695..84fa862da 100644
--- a/docs/Interceptors.md
+++ b/docs/Interceptors.md
@@ -383,5 +383,5 @@ To use them, first require them:
 
 ---
 Previous:  [Effectful Handlers](EffectfulHandlers.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 Next:  [Effects](Effects.md)  
diff --git a/docs/Loading-Initial-Data.md b/docs/Loading-Initial-Data.md
index d1059eb5a..20aed841f 100644
--- a/docs/Loading-Initial-Data.md
+++ b/docs/Loading-Initial-Data.md
@@ -217,7 +217,7 @@ The next Tutorial will show you how.
 
 ---
 Previous:  [Namespaced Keywords](Namespaced-Keywords.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 Next:  [Talking To Servers](Talking-To-Servers.md)  
 
  
diff --git a/docs/Namespaced-Keywords.md b/docs/Namespaced-Keywords.md
index 6fe019f6b..4bc801a5b 100644
--- a/docs/Namespaced-Keywords.md
+++ b/docs/Namespaced-Keywords.md
@@ -22,5 +22,5 @@ which are both unique and descriptive.
 
 ---
 Previous:  [Navigation](Navigation.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 Next:  [Loading Initial Data](Loading-Initial-Data.md)  
\ No newline at end of file
diff --git a/docs/Navigation.md b/docs/Navigation.md
index 89530239e..e4151166c 100644
--- a/docs/Navigation.md
+++ b/docs/Navigation.md
@@ -51,5 +51,5 @@ Continue to [Namespaced Keywords](Namespaced-Keywords.md) to reduce clashes on i
 
 ---
 Previous:  [Navigation](Navigation.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 Next:  [Namespaced Keywords](Namespaced-Keywords.md)
diff --git a/docs/Subscribing-To-External-Data.md b/docs/Subscribing-To-External-Data.md
index 35e738342..54395bc14 100644
--- a/docs/Subscribing-To-External-Data.md
+++ b/docs/Subscribing-To-External-Data.md
@@ -236,3 +236,6 @@ data into HTML and nothing more. they absolutely do not do imperative stuff.
 
 Use one of the two alternatives described above.
  
+---
+Previous:  [Talking to Servers](Talking-To-Servers.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
diff --git a/docs/Talking-To-Servers.md b/docs/Talking-To-Servers.md
index 07410cfe8..78de6159a 100644
--- a/docs/Talking-To-Servers.md
+++ b/docs/Talking-To-Servers.md
@@ -140,5 +140,6 @@ Notes:
   
   
 ---
-Previous:  [Talking To Servers](Talking-To-Servers.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Previous:  [Loading Initial Data](Loading-Initial-Data.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Next:  [Subscribing to External Data](Subscribing-To-External-Data.md)  
diff --git a/docs/coeffects.md b/docs/coeffects.md
index f9c56a827..ee1bcd9ed 100644
--- a/docs/coeffects.md
+++ b/docs/coeffects.md
@@ -269,5 +269,5 @@ In note form:
    
 ---
 Previous:  [Effects](Effects.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-Up:  [Index](Readme.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Up:  [Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 Next:  [Basic App Structure](Basic-App-Structure.md)  

From 436bd5917b66a87a27696c8f9a2e60332e1eb375 Mon Sep 17 00:00:00 2001
From: Shaun Mahood <smahodo@Shauns-Air.lan>
Date: Sun, 28 Aug 2016 09:55:29 -0600
Subject: [PATCH 04/12] Fix docs navigation in navigation doc
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Quite the commit message, isn’t it?
---
 docs/Navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/Navigation.md b/docs/Navigation.md
index e4151166c..8fb27852c 100644
--- a/docs/Navigation.md
+++ b/docs/Navigation.md
@@ -50,6 +50,6 @@ A high level reagent view has a subscription to :active-panel and will switch to
 Continue to [Namespaced Keywords](Namespaced-Keywords.md) to reduce clashes on ids.
 
 ---
-Previous:  [Navigation](Navigation.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+Previous:  [Basic App Structure](Basic-App-Structure.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 Up:  [Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 Next:  [Namespaced Keywords](Namespaced-Keywords.md)

From a0679e12a2dfea6acd731d3150aaf4a92c355470 Mon Sep 17 00:00:00 2001
From: Mike Thompson <mike.thompson@day8.com.au>
Date: Mon, 29 Aug 2016 13:11:15 +1000
Subject: [PATCH 05/12] More docs

---
 .idea/codeStyleSettings.xml          |  1 +
 docs/README.md                       |  9 ++-
 docs/The-ref-frame-logo.md           | 45 +++++++++++++
 docs/Using-Stateful-JS-Components.md | 94 ++++++++++++++++++++++++++++
 images/logo/README.md                | 37 +----------
 5 files changed, 150 insertions(+), 36 deletions(-)
 create mode 100644 docs/The-ref-frame-logo.md
 create mode 100644 docs/Using-Stateful-JS-Components.md

diff --git a/.idea/codeStyleSettings.xml b/.idea/codeStyleSettings.xml
index c374ce3f7..adb5ab925 100644
--- a/.idea/codeStyleSettings.xml
+++ b/.idea/codeStyleSettings.xml
@@ -12,5 +12,6 @@
       </value>
     </option>
     <option name="USE_PER_PROJECT_SETTINGS" value="true" />
+    <option name="PREFERRED_PROJECT_CODE_STYLE" value="Default (2)" />
   </component>
 </project>
\ No newline at end of file
diff --git a/docs/README.md b/docs/README.md
index 044bd9f03..054c75041 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -18,4 +18,11 @@
 
 1. [Loading Initial Data](Loading-Initial-Data.md)
 2. [Talking To Servers](Talking-To-Servers.md)
-3. [Subscribing to External Data](Subscribing-To-External-Data.md)
\ No newline at end of file
+3. [Subscribing to External Data](Subscribing-To-External-Data.md)
+
+
+
+## Miscellaneous:
+
+1. [Using Stateful JS Components.md](Using-Stateful-JS-Components.md)
+2. [The re-frame Logo](The-ref-frame-logo.md)
diff --git a/docs/The-ref-frame-logo.md b/docs/The-ref-frame-logo.md
new file mode 100644
index 000000000..bc097cd94
--- /dev/null
+++ b/docs/The-ref-frame-logo.md
@@ -0,0 +1,45 @@
+## The re-frame Logo
+
+![logo](/images/logo/re-frame_256w.png?raw=true)
+
+### Who
+
+Created by the mysterious deep thinker, known only as @martinklepsch.
+
+Some say he appears on high value stamps in Germany and that he once 
+punched a horse to the ground. Others say he loves recursion so much 
+that, in his wallet, he carries a photograph of his wallet.
+
+All we know for sure is that he wields [Sketch.app](https://www.sketchapp.com/) like
+Bruce Lee wielded nunchucks.
+
+### Genesis Theories
+
+Great, unexplained works encourage fan theories, and the re-frame logo
+is no exception.
+
+A noisy bunch think @martinklepsch wanted to `Put the 'f' back into infinity`. They have t-shirts. 
+
+Others speculate he created the logo as a bifarious rainbow homage
+to Frank Lloyd Wright's masterpiece, the Guggenheim Museum. A classic case 
+of premature abstraction and over engineering if you ask me. Their theory, not the Guggenheim.
+
+![](/images/logo/Guggenheim.jpg)
+
+The infamous "Bad Touch" faction look at the logo and see the cljs logo mating noisily with re-frame's official 
+architecture diagram. Attend one of their parties and you have a 50% chance of arrest. 
+
+![](/images/logo/Genesis.png)
+
+The Functional Fundamentalists, a stern bunch, see the logo as a flowing poststructuralist rebuttal of OO's
+vowel duplication and horizontal adjacency. Their approach, FF, is apparently fine because "everyone loves a
+fricative".
+
+For his part, @martinklepsch has never confirmed any theory, teasing us instead with coded clues 
+like "Will you please stop emailing me" and "Why did you say I hit a horse?".
+
+### Assets Where?
+
+Within this repo, look in `/images/logo/`
+
+
diff --git a/docs/Using-Stateful-JS-Components.md b/docs/Using-Stateful-JS-Components.md
new file mode 100644
index 000000000..433db7521
--- /dev/null
+++ b/docs/Using-Stateful-JS-Components.md
@@ -0,0 +1,94 @@
+## Using Stateful JS Components 
+
+You know what's good for you, and you know what's right.  But it
+doesn't matter - the wickedness of the temptation is too much. 
+
+The JS world is brimming with shiny component baubles: D3, 
+Google Maps, Chosen, etc.  
+
+But they are salaciously stateful and mutative.  And, you, 
+raised in a pure, functional home, with caring, immutable parents, 
+know they are wrong.  But, my, how you still yearn for the sweet 
+thrill of that forbidden fruit. 
+
+I won't tell, if you don't.  But careful plans must be made  ... 
+
+
+### The overall plan 
+
+To use a stateful js component, you'll need to write two Reagent components:
+  - an **outer component** responsible for sourcing data via a subscription or r/atom or cursor, etc.  
+  - an **inner component** responsible for wrapping and manipulating the stateful JS component via lifecycle functions.  
+
+The pattern involves the outer component, which sources data, supplying this data to the inner component **via props**. 
+
+### Example Using Google Maps
+
+```cljs
+(defn gmap-inner []
+  (let [gmap    (atom nil)
+        options (clj->js {"zoom" 9})
+        update  (fn [comp]
+                  (let [{:keys [latitude longitude]} (reagent/props comp)
+                        latlng (js/google.maps.LatLng. latitude longitude)]
+                    (.setPosition (:marker @gmap) latlng)
+                    (.panTo (:map @gmap) latlng)))]
+
+    (reagent/create-class
+      {:reagent-render (fn []
+                         [:div
+                          [:h4 "Map"]
+                          [:div#map-canvas {:style {:height "400px"}}]])
+
+       :component-did-mount (fn [comp]
+                              (let [canvas  (.getElementById js/document "map-canvas")
+                                    gm      (js/google.maps.Map. canvas options)
+                                    marker  (js/google.maps.Marker. (clj->js {:map gm :title "Drone"}))]
+                                (reset! gmap {:map gm :marker marker}))
+                              (update comp))
+
+       :component-did-update update
+       :display-name "gmap-inner"})))
+
+
+
+(defn gmap-outer []
+  (let [pos (subscribe [:current-position])]   ;; obtain the data
+    (fn []
+      [gmap-inner @pos])))
+```
+
+
+Notes:
+  - `gmap-outer` obtains data via a subscription. It is quite simple - trivial almost.
+  - it then passes this data __as a prop__  to `gmap-inner`.  This inner component has the job of wrapping/managing the stateful js component (Gmap in our case above)
+  - when the data (delivered by the subscription) to the outer layer changes, the inner layer, `gmap-inner`, will be given a new prop - `@pos` in the case above.
+  - when the inner component is given new props, its entire set of lifecycle functions will be engaged. 
+  - the renderer for the inner layer ALWAYS renders the same, minimal container hiccup for the component.  Even though the `props` have changed, the same hiccup is output. So it will appear to React as if nothing changes from one render to the next. No work to be done. React/Reagent will leave the DOM untouched. 
+  - but this inner component has other lifecycle functions and this is where the real work is done.  
+  - for example, after the renderer is called (which ignores its props), `component-did-update` will be called. In this function, we don't ignore the props, and we use them to update/mutate the stateful JS component.  
+  - the props passed (in this case `@pos`) in must be a map, otherwise `(reagent/props comp)` will return nil.
+
+### Pattern Discovery 
+
+This pattern has been independently discovered by many. To my knowledge, 
+[this description of the Container/Component pattern](https://medium.com/@learnreact/container-components-c0e67432e005#.3ic1uipvu)
+is the first time it was written up.
+
+### Code Credit
+
+The example gmaps code above was developed by @jhchabran in this gist:
+https://gist.github.com/jhchabran/e09883c3bc1b703a224d#file-2_google_map-cljs
+
+### D3 Examples
+
+D3 (from @zachcp): 
+  - Blog Post: http://zachcp.org/blog/2015/reagent-d3/
+  - Code: https://github.com/zachcp/simplecomponent
+  - Example: http://zachcp.github.io/simplecomponent/
+
+
+### Advanced Lifecycle Methods
+
+If you mess around with lifecycle methods, you'll probably want to read Martin's explanations:
+https://www.martinklepsch.org/posts/props-children-and-component-lifecycle-in-reagent.html
diff --git a/images/logo/README.md b/images/logo/README.md
index 26a1685c7..fff87ac7b 100644
--- a/images/logo/README.md
+++ b/images/logo/README.md
@@ -1,40 +1,7 @@
-## The re-frame Logo
 
-![logo](/images/logo/re-frame_256w.png?raw=true)
-
-Created by the mysterious @martinklepsch
-
-Some say he appears on high value stamps in Germany and that he once 
-punched a horse to the ground. Others say he loves recursion so much 
-that his wallet contains a photograph of his wallet.
-
-All we know for sure is that he wields [Sketch.app](https://www.sketchapp.com/) like
-Bruce Lee wielded nunchucks.
-
-## Genesis Theories
-
-Great, unexplained works encourage fan theories, and the re-frame logo
-is no exception.
-
-Some speculate @martinklepsch created it as a bifarious rainbow homage
-to Frank Lloyd Wright's Guggenheim.
 
-![](Guggenheim.jpg)
-
-Others see the cljs logo mating noisily with re-frame's official 
-architecture diagram.
-
-![](Genesis.png)
-
-Yet others see a poststructuralist rebuttal of OO's
-vowel duplication and horizontal adjacency. Their T-shirts claim:  
-> He's put the 'f' back into infinity
-
-For his part, Martin has never confirmed any theory, teasing us instead with coded clues 
-like "Will you please stop emailing me" and "Why did you say I hit a horse?".
-
-### Notes 
+![logo](/images/logo/re-frame_256w.png?raw=true)
 
-Use [Sketch.app](https://www.sketchapp.com/) to update the `re-frame-logo.sketch` file.
+Created via [Sketch.app](https://www.sketchapp.com/). See the file `re-frame-logo.sketch`
 
 Unfortunately the gradients are not exported properly so we can't provide an SVG here for now.

From 651cbd7059fea415dcf7158ab30ed0c717911656 Mon Sep 17 00:00:00 2001
From: Mike Thompson <mike.thompson@day8.com.au>
Date: Mon, 29 Aug 2016 14:05:29 +1000
Subject: [PATCH 06/12] docs

---
 docs/README.md             | 2 +-
 docs/The-ref-frame-logo.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/README.md b/docs/README.md
index 054c75041..7907db04b 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -24,5 +24,5 @@
 
 ## Miscellaneous:
 
-1. [Using Stateful JS Components.md](Using-Stateful-JS-Components.md)
+1. [Using Stateful JS Components](Using-Stateful-JS-Components.md)
 2. [The re-frame Logo](The-ref-frame-logo.md)
diff --git a/docs/The-ref-frame-logo.md b/docs/The-ref-frame-logo.md
index bc097cd94..ffa597993 100644
--- a/docs/The-ref-frame-logo.md
+++ b/docs/The-ref-frame-logo.md
@@ -18,7 +18,7 @@ Bruce Lee wielded nunchucks.
 Great, unexplained works encourage fan theories, and the re-frame logo
 is no exception.
 
-A noisy bunch think @martinklepsch wanted to `Put the 'f' back into infinity`. They have t-shirts. 
+A noisy bunch think @martinklepsch simply wanted to `Put the 'f' back into infinity`. They have t-shirts. 
 
 Others speculate he created the logo as a bifarious rainbow homage
 to Frank Lloyd Wright's masterpiece, the Guggenheim Museum. A classic case 

From a4d341ec4bb2c4428d3ed3e2b894a9c0cf7da3d9 Mon Sep 17 00:00:00 2001
From: Mike Thompson <mike.thompson@day8.com.au>
Date: Mon, 29 Aug 2016 22:57:35 +1000
Subject: [PATCH 07/12] WIP on FAQ

---
 docs/FAQs/Inspecting-app-db.md      | 58 +++++++++++++++++++++++++++++
 docs/FAQs/Logging.md                | 24 ++++++++++++
 docs/FAQs/Null-Dispatched-Events.md | 17 +++++++++
 docs/FAQs/README.md                 | 15 ++++++++
 docs/FAQs/Why-CLJC.md               | 19 ++++++++++
 docs/README.md                      |  6 +--
 docs/The-ref-frame-logo.md          |  4 +-
 7 files changed, 138 insertions(+), 5 deletions(-)
 create mode 100644 docs/FAQs/Inspecting-app-db.md
 create mode 100644 docs/FAQs/Logging.md
 create mode 100644 docs/FAQs/Null-Dispatched-Events.md
 create mode 100644 docs/FAQs/README.md
 create mode 100644 docs/FAQs/Why-CLJC.md

diff --git a/docs/FAQs/Inspecting-app-db.md b/docs/FAQs/Inspecting-app-db.md
new file mode 100644
index 000000000..e4b44f4d2
--- /dev/null
+++ b/docs/FAQs/Inspecting-app-db.md
@@ -0,0 +1,58 @@
+
+## Question
+
+How can I inspect the contents of `app-db`?  Perhaps from figwheel.
+
+## Short Answer
+
+If at a REPL, inspect:  `re-frame.db/app-db`.  
+
+If at the js console, that's `window.re_frame.db.app_db.state`.
+
+You are [using clj-devtools](https://github.com/binaryage/cljs-devtools), right? 
+If not, stop everything and immediately make that happen. 
+
+## Better Answer
+
+Are you sure you need to?  
+
+First, you seldom want to inspect all of `app-db`. 
+And, second, inspecting via figwheel will be clumsy. 
+
+Instead, you probably want to inspect a part of `app-db`. And you probably want 
+to inspect it in the GUI itself.
+
+Here is a useful technique from @escherize. Add something like this to 
+the hiccup of your view ...
+```clj
+[:pre (with-out-str (pprint @interesting))] 
+```
+This assumes that `@interesting` is the value (ratom or subscription) you want to observe (note the @ in front).
+
+`pprint` output is nice to read, but not compact. For a more compact view, do this: 
+```clj
+[:pre (pr-str @some-atom)]      ;; using pr-str instead of pprint
+```
+
+If you choose to use `pprint` then you'll need to `require` it in at the top of your view.cljs:
+```clj
+[cljs.pprint :refer [pprint]]
+```
+
+@yogthos' [excellent json-html library](https://github.com/yogthos/json-html) has an 
+even slicker presentation (at the expense of more screen real estate, and the 
+need to include specific CSS).
+
+Finally, combining the short and long answers, you could even do this:
+```clj
+[:pre (with-out-str (pprint @re-frame.db/app-db))]    ;; see everything!
+```
+or 
+```clj
+[:pre (with-out-str (pprint (:part @re-frame.db/app-db)))]    ;; see a part of it!
+```
+
+You definitely have [clj-devtools](https://github.com/binaryage/cljs-devtools) installed now, right?
+
+
+Up:  [FAQ Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
diff --git a/docs/FAQs/Logging.md b/docs/FAQs/Logging.md
new file mode 100644
index 000000000..c0bab115d
--- /dev/null
+++ b/docs/FAQs/Logging.md
@@ -0,0 +1,24 @@
+### Question
+
+I use logging method X, how can I make re-frame use my method? 
+
+## Answer
+
+re-frame makes use of the logging functions: `warn`, `log`, `error`, `group` and `groupEnd`.  
+
+By default, these functions map directly to the js/console equivalents, but you can 
+override that by providing your own set or subset of these functions using 
+`re-frame.core/set-loggers!` like this:
+```clj
+(defn my-warn
+   [& args]      
+   (my-special-warner (apply str args)))
+
+(defn my-log
+   [& args]
+   (my-special-logger (apply str args)))
+
+(re-frame.core/set-loggers!  {:warn  my-warn   
+                              :log   my-log 
+                              ...})
+```
diff --git a/docs/FAQs/Null-Dispatched-Events.md b/docs/FAQs/Null-Dispatched-Events.md
new file mode 100644
index 000000000..87708fbe7
--- /dev/null
+++ b/docs/FAQs/Null-Dispatched-Events.md
@@ -0,0 +1,17 @@
+## Question
+
+If I `dispatch` a js event object (from a view), it is nullified 
+by the time it gets to the event-handler. What gives? 
+
+## Answer
+
+So there's two things to say about this:
+- if you want to `dispatch` a js event object to a re-frame 
+  event handler, you must call `(.persist event)` before the `dispatch`. 
+  React recycles events (using a pool), and re-frame event handlers 
+  run async.  [Find out more here](https://facebook.github.io/react/docs/events.html)
+  
+- it is probably more idiomatic to extract the salient data from the event 
+  and `dispatch` that, rather than the js event object itself. When you 
+  `dispatch` pure, simple cljs data (ie. rather than js objects) testing 
+  and debugging will become easier. 
diff --git a/docs/FAQs/README.md b/docs/FAQs/README.md
new file mode 100644
index 000000000..81d86060a
--- /dev/null
+++ b/docs/FAQs/README.md
@@ -0,0 +1,15 @@
+## Frequently Asked Questions
+
+1. [How can I Inspect app-db?](Inspecting-app-db.md)
+2. [How do I use logging method X](Logging.md)
+3. [Dispatched Events Are Null](Null-Dispatched-Events.md)
+4.
+5.
+6.  [Why implement re-frame in `.cljc` files](Why-CLJC.md)
+
+
+
+
+### Want To Add An FAQ?  
+
+We'd like that.  Please supply a PR.  Or just open an issue. Many Thanks!!
diff --git a/docs/FAQs/Why-CLJC.md b/docs/FAQs/Why-CLJC.md
new file mode 100644
index 000000000..9dd694e29
--- /dev/null
+++ b/docs/FAQs/Why-CLJC.md
@@ -0,0 +1,19 @@
+## Question
+
+Why is re-frame implemented as `.cljc` file?   Aren't ClojureScript 
+files meant to be `.cljs`?
+
+## Answer 
+
+So tests can be run on both the JVM and the JS platforms,  
+re-frame's implementation is mostly in `.cljc` files. 
+ 
+The trailing `c` in `.cljc` stands for `common`.  
+
+Necessary interop for each platform can be found in 
+`interop.clj`  (for the JVM)  and `interop.cljs` (for JS).
+
+See also: https://github.com/Day8/re-frame-test
+
+
+Up:  [FAQ Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
diff --git a/docs/README.md b/docs/README.md
index 7907db04b..bc86ce39c 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -23,6 +23,6 @@
 
 
 ## Miscellaneous:
-
-1. [Using Stateful JS Components](Using-Stateful-JS-Components.md)
-2. [The re-frame Logo](The-ref-frame-logo.md)
+1. [FAQs](FAQS/README.md)
+2. [Using Stateful JS Components](Using-Stateful-JS-Components.md)
+3. [The re-frame Logo](The-ref-frame-logo.md)
diff --git a/docs/The-ref-frame-logo.md b/docs/The-ref-frame-logo.md
index ffa597993..d5ea44d31 100644
--- a/docs/The-ref-frame-logo.md
+++ b/docs/The-ref-frame-logo.md
@@ -18,9 +18,9 @@ Bruce Lee wielded nunchucks.
 Great, unexplained works encourage fan theories, and the re-frame logo
 is no exception.
 
-A noisy bunch think @martinklepsch simply wanted to `Put the 'f' back into infinity`. They have t-shirts. 
+One noisy group think @martinklepsch simply wanted to `Put the 'f' back into infinity`. They have t-shirts. 
 
-Others speculate he created the logo as a bifarious rainbow homage
+Another group speculates that he created the logo as a bifarious rainbow homage
 to Frank Lloyd Wright's masterpiece, the Guggenheim Museum. A classic case 
 of premature abstraction and over engineering if you ask me. Their theory, not the Guggenheim.
 

From 8260e41c60786f464ac961380acf5d349f48d1d5 Mon Sep 17 00:00:00 2001
From: Mike Thompson <mike.thompson@day8.com.au>
Date: Mon, 29 Aug 2016 22:58:45 +1000
Subject: [PATCH 08/12] link correction

---
 docs/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/README.md b/docs/README.md
index bc86ce39c..20eb3a6d9 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -23,6 +23,6 @@
 
 
 ## Miscellaneous:
-1. [FAQs](FAQS/README.md)
+1. [FAQs](FAQs/README.md)
 2. [Using Stateful JS Components](Using-Stateful-JS-Components.md)
 3. [The re-frame Logo](The-ref-frame-logo.md)

From 781e7ca323180fa37674bbaa9dfdfc0f06343940 Mon Sep 17 00:00:00 2001
From: Mike Thompson <mike.thompson@day8.com.au>
Date: Mon, 29 Aug 2016 23:06:41 +1000
Subject: [PATCH 09/12] Experiment with FAQ formatting

---
 docs/FAQs/Inspecting-app-db.md      | 7 ++++---
 docs/FAQs/Logging.md                | 5 ++++-
 docs/FAQs/Null-Dispatched-Events.md | 8 ++++++--
 docs/FAQs/README.md                 | 1 -
 docs/FAQs/Why-CLJC.md               | 7 ++++---
 5 files changed, 18 insertions(+), 10 deletions(-)

diff --git a/docs/FAQs/Inspecting-app-db.md b/docs/FAQs/Inspecting-app-db.md
index e4b44f4d2..275c0bd77 100644
--- a/docs/FAQs/Inspecting-app-db.md
+++ b/docs/FAQs/Inspecting-app-db.md
@@ -1,9 +1,9 @@
 
-## Question
+### Question
 
 How can I inspect the contents of `app-db`?  Perhaps from figwheel.
 
-## Short Answer
+### Short Answer
 
 If at a REPL, inspect:  `re-frame.db/app-db`.  
 
@@ -12,7 +12,7 @@ If at the js console, that's `window.re_frame.db.app_db.state`.
 You are [using clj-devtools](https://github.com/binaryage/cljs-devtools), right? 
 If not, stop everything and immediately make that happen. 
 
-## Better Answer
+### Better Answer
 
 Are you sure you need to?  
 
@@ -55,4 +55,5 @@ or
 You definitely have [clj-devtools](https://github.com/binaryage/cljs-devtools) installed now, right?
 
 
+---
 Up:  [FAQ Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
diff --git a/docs/FAQs/Logging.md b/docs/FAQs/Logging.md
index c0bab115d..3cb7a6b87 100644
--- a/docs/FAQs/Logging.md
+++ b/docs/FAQs/Logging.md
@@ -2,7 +2,7 @@
 
 I use logging method X, how can I make re-frame use my method? 
 
-## Answer
+### Answer
 
 re-frame makes use of the logging functions: `warn`, `log`, `error`, `group` and `groupEnd`.  
 
@@ -22,3 +22,6 @@ override that by providing your own set or subset of these functions using
                               :log   my-log 
                               ...})
 ```
+
+---
+Up:  [FAQ Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
diff --git a/docs/FAQs/Null-Dispatched-Events.md b/docs/FAQs/Null-Dispatched-Events.md
index 87708fbe7..a0e939e6a 100644
--- a/docs/FAQs/Null-Dispatched-Events.md
+++ b/docs/FAQs/Null-Dispatched-Events.md
@@ -1,9 +1,9 @@
-## Question
+### Question
 
 If I `dispatch` a js event object (from a view), it is nullified 
 by the time it gets to the event-handler. What gives? 
 
-## Answer
+### Answer
 
 So there's two things to say about this:
 - if you want to `dispatch` a js event object to a re-frame 
@@ -15,3 +15,7 @@ So there's two things to say about this:
   and `dispatch` that, rather than the js event object itself. When you 
   `dispatch` pure, simple cljs data (ie. rather than js objects) testing 
   and debugging will become easier. 
+  
+  
+---
+Up:  [FAQ Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
diff --git a/docs/FAQs/README.md b/docs/FAQs/README.md
index 81d86060a..8ca2e76dc 100644
--- a/docs/FAQs/README.md
+++ b/docs/FAQs/README.md
@@ -4,7 +4,6 @@
 2. [How do I use logging method X](Logging.md)
 3. [Dispatched Events Are Null](Null-Dispatched-Events.md)
 4.
-5.
 6.  [Why implement re-frame in `.cljc` files](Why-CLJC.md)
 
 
diff --git a/docs/FAQs/Why-CLJC.md b/docs/FAQs/Why-CLJC.md
index 9dd694e29..1397dbc3f 100644
--- a/docs/FAQs/Why-CLJC.md
+++ b/docs/FAQs/Why-CLJC.md
@@ -1,9 +1,9 @@
-## Question
+### Question
 
-Why is re-frame implemented as `.cljc` file?   Aren't ClojureScript 
+Why is re-frame implemented in `.cljc` files?   Aren't ClojureScript 
 files meant to be `.cljs`?
 
-## Answer 
+### Answer 
 
 So tests can be run on both the JVM and the JS platforms,  
 re-frame's implementation is mostly in `.cljc` files. 
@@ -16,4 +16,5 @@ Necessary interop for each platform can be found in
 See also: https://github.com/Day8/re-frame-test
 
 
+---
 Up:  [FAQ Index](README.md)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;

From 6db396381f8578ba0fc9584a3bf14ade23552eaa Mon Sep 17 00:00:00 2001
From: Mike Thompson <mike.thompson@day8.com.au>
Date: Mon, 29 Aug 2016 23:49:00 +1000
Subject: [PATCH 10/12] More misc docs

---
 docs/FAQs/Logging.md       |  4 ++--
 docs/FAQs/Why-CLJC.md      |  4 ++--
 docs/The-ref-frame-logo.md | 41 +++++++++++++++++++++-----------------
 3 files changed, 27 insertions(+), 22 deletions(-)

diff --git a/docs/FAQs/Logging.md b/docs/FAQs/Logging.md
index 3cb7a6b87..08c8a54d5 100644
--- a/docs/FAQs/Logging.md
+++ b/docs/FAQs/Logging.md
@@ -12,11 +12,11 @@ override that by providing your own set or subset of these functions using
 ```clj
 (defn my-warn
    [& args]      
-   (my-special-warner (apply str args)))
+   (post-warning-somewhere (apply str args)))
 
 (defn my-log
    [& args]
-   (my-special-logger (apply str args)))
+   (write-to-datadog (apply str args)))
 
 (re-frame.core/set-loggers!  {:warn  my-warn   
                               :log   my-log 
diff --git a/docs/FAQs/Why-CLJC.md b/docs/FAQs/Why-CLJC.md
index 1397dbc3f..0c9c2e47b 100644
--- a/docs/FAQs/Why-CLJC.md
+++ b/docs/FAQs/Why-CLJC.md
@@ -5,12 +5,12 @@ files meant to be `.cljs`?
 
 ### Answer 
 
-So tests can be run on both the JVM and the JS platforms,  
+So tests can be run on both the JVM and the JS platforms,
 re-frame's implementation is mostly in `.cljc` files. 
  
 The trailing `c` in `.cljc` stands for `common`.  
 
-Necessary interop for each platform can be found in 
+Necessary interop for each platform can be found in
 `interop.clj`  (for the JVM)  and `interop.cljs` (for JS).
 
 See also: https://github.com/Day8/re-frame-test
diff --git a/docs/The-ref-frame-logo.md b/docs/The-ref-frame-logo.md
index d5ea44d31..f96b3883c 100644
--- a/docs/The-ref-frame-logo.md
+++ b/docs/The-ref-frame-logo.md
@@ -4,39 +4,44 @@
 
 ### Who
 
-Created by the mysterious deep thinker, known only as @martinklepsch.
+Created by the mysterious, deep thinker, known only as @martinklepsch.
 
-Some say he appears on high value stamps in Germany and that he once 
-punched a horse to the ground. Others say he loves recursion so much 
+Some say he appears on high value stamps in Germany and that he once <br>
+punched a horse to the ground. Others say he loves recursion so much <br>
 that, in his wallet, he carries a photograph of his wallet.
 
-All we know for sure is that he wields [Sketch.app](https://www.sketchapp.com/) like
-Bruce Lee wielded nunchucks.
+All we know for sure is that he wields [Sketch.app](https://www.sketchapp.com/)<br>
+like Bruce Lee wielded nunchucks.
 
 ### Genesis Theories
 
-Great, unexplained works encourage fan theories, and the re-frame logo
-is no exception.
+Great, unexplained works encourage fan theories, and <br>
+the re-frame logo is no exception.
 
-One noisy group think @martinklepsch simply wanted to `Put the 'f' back into infinity`. They have t-shirts. 
+One noisy group think @martinklepsch simply wanted to <br>
+`Put the 'f' back into infinity`. They have t-shirts. 
 
-Another group speculates that he created the logo as a bifarious rainbow homage
-to Frank Lloyd Wright's masterpiece, the Guggenheim Museum. A classic case 
-of premature abstraction and over engineering if you ask me. Their theory, not the Guggenheim.
+Another group speculates that he created the logo as a <br>
+bifarious rainbow homage to Frank Lloyd Wright's masterpiece, <br>
+the Guggenheim Museum. A classic case of premature abstraction <br>
+and over engineering if you ask me. Their theory, not the Guggenheim.
 
 ![](/images/logo/Guggenheim.jpg)
 
-The infamous "Bad Touch" faction look at the logo and see the cljs logo mating noisily with re-frame's official 
-architecture diagram. Attend one of their parties and you have a 50% chance of arrest. 
+The infamous "Bad Touch" faction look at the logo and see the <br>
+cljs logo mating noisily with re-frame's official architecture <br>
+diagram. Attend one of their parties and you have a 50% chance of arrest. 
 
 ![](/images/logo/Genesis.png)
 
-The Functional Fundamentalists, a stern bunch, see the logo as a flowing poststructuralist rebuttal of OO's
-vowel duplication and horizontal adjacency. Their approach, FF, is apparently fine because "everyone loves a
-fricative".
+The Functional Fundamentalists, a stern bunch, see the logo as <br>
+a flowing poststructuralist rebuttal of OO's vowel duplication <br>
+and horizontal adjacency. Their approach, FF, is apparently fine <br>
+because "everyone loves a fricative".
 
-For his part, @martinklepsch has never confirmed any theory, teasing us instead with coded clues 
-like "Will you please stop emailing me" and "Why did you say I hit a horse?".
+For his part, @martinklepsch has never confirmed any theory, <br>
+teasing us instead with coded clues like "Will you please stop emailing me"<br>
+and "Why did you say I hit a horse?".
 
 ### Assets Where?
 

From 11821950b598eda3a45a1292d569dd0f7cfe420e Mon Sep 17 00:00:00 2001
From: Mike Thompson <mike.thompson@day8.com.au>
Date: Tue, 30 Aug 2016 00:00:15 +1000
Subject: [PATCH 11/12] Experiment with line width for easy reading.

---
 docs/The-ref-frame-logo.md | 40 +++++++++++++++++++-------------------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/docs/The-ref-frame-logo.md b/docs/The-ref-frame-logo.md
index f96b3883c..0b580afba 100644
--- a/docs/The-ref-frame-logo.md
+++ b/docs/The-ref-frame-logo.md
@@ -7,40 +7,40 @@
 Created by the mysterious, deep thinker, known only as @martinklepsch.
 
 Some say he appears on high value stamps in Germany and that he once <br>
-punched a horse to the ground. Others say he loves recursion so much <br>
-that, in his wallet, he carries a photograph of his wallet.
+punched a horse to the ground. Others say he loves recursion so much that, <br>
+in his wallet, he carries a photograph of his wallet.
 
-All we know for sure is that he wields [Sketch.app](https://www.sketchapp.com/)<br>
-like Bruce Lee wielded nunchucks.
+All we know for sure is that he wields [Sketch.app](https://www.sketchapp.com/) like Bruce Lee <br>
+wielded nunchucks.
 
 ### Genesis Theories
 
-Great, unexplained works encourage fan theories, and <br>
-the re-frame logo is no exception.
+Great, unexplained works encourage fan theories, and the re-frame <br>
+logo is no exception.
 
 One noisy group think @martinklepsch simply wanted to <br>
-`Put the 'f' back into infinity`. They have t-shirts. 
+`Put the 'f' back into infinity`. They have t-shirts.
 
-Another group speculates that he created the logo as a <br>
-bifarious rainbow homage to Frank Lloyd Wright's masterpiece, <br>
-the Guggenheim Museum. A classic case of premature abstraction <br>
-and over engineering if you ask me. Their theory, not the Guggenheim.
+Another group speculates that he created the logo as a bifarious  <br>
+rainbow homage to Frank Lloyd Wright's masterpiece, the Guggenheim <br>
+Museum. A classic case of premature abstraction and over engineering <br>
+if you ask me. Their theory, not the Guggenheim.
 
 ![](/images/logo/Guggenheim.jpg)
 
-The infamous "Bad Touch" faction look at the logo and see the <br>
-cljs logo mating noisily with re-frame's official architecture <br>
-diagram. Attend one of their parties and you have a 50% chance of arrest. 
+The infamous "Bad Touch" faction look at the logo and see the cljs <br>
+logo mating noisily with re-frame's official architecture diagram. <br>
+Attend one of their parties and you have a 50% chance of arrest. 
 
 ![](/images/logo/Genesis.png)
 
-The Functional Fundamentalists, a stern bunch, see the logo as <br>
-a flowing poststructuralist rebuttal of OO's vowel duplication <br>
-and horizontal adjacency. Their approach, FF, is apparently fine <br>
-because "everyone loves a fricative".
+The Functional Fundamentalists, a stern bunch, see the logo as a <br>
+flowing poststructuralist rebuttal of OO's vowel duplication and <br>
+horizontal adjacency. Their alternative pproach, FF, is apparently <br>
+fine because "everyone loves a fricative".
 
-For his part, @martinklepsch has never confirmed any theory, <br>
-teasing us instead with coded clues like "Will you please stop emailing me"<br>
+For his part, @martinklepsch has never confirmed any theory, teasing <br>
+us instead with coded clues like "Will you please stop emailing me" <br>
 and "Why did you say I hit a horse?".
 
 ### Assets Where?

From 7a2dcb3f589320a4a9afb6a364ef9f052b67849d Mon Sep 17 00:00:00 2001
From: Mike Thompson <mike.thompson@day8.com.au>
Date: Tue, 30 Aug 2016 00:59:53 +1000
Subject: [PATCH 12/12] Get the line lengths right, to make reading flow.

---
 docs/The-ref-frame-logo.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/The-ref-frame-logo.md b/docs/The-ref-frame-logo.md
index 0b580afba..d73e1e9eb 100644
--- a/docs/The-ref-frame-logo.md
+++ b/docs/The-ref-frame-logo.md
@@ -18,7 +18,7 @@ wielded nunchucks.
 Great, unexplained works encourage fan theories, and the re-frame <br>
 logo is no exception.
 
-One noisy group think @martinklepsch simply wanted to <br>
+One noisy group thinks @martinklepsch simply wanted to <br>
 `Put the 'f' back into infinity`. They have t-shirts.
 
 Another group speculates that he created the logo as a bifarious  <br>
@@ -36,7 +36,7 @@ Attend one of their parties and you have a 50% chance of arrest.
 
 The Functional Fundamentalists, a stern bunch, see the logo as a <br>
 flowing poststructuralist rebuttal of OO's vowel duplication and <br>
-horizontal adjacency. Their alternative pproach, FF, is apparently <br>
+horizontal adjacency. Their alternative approach, FF, is apparently <br>
 fine because "everyone loves a fricative".
 
 For his part, @martinklepsch has never confirmed any theory, teasing <br>