README.md in gara-0.1.6 vs README.md in gara-0.1.7

@@ -14,31 +14,46 @@
 
     html(lang: "en") {
       head {
         meta charset: 'utf-8'
         meta name: 'viewport', content: "width=device-width, initial-scale=1.0"
-        title yield(:title)
+        title {
+          content_for(:title)
+        }
         stylesheet_link_tag "application", media: 'all', 'data-turbolinks-track' => true
-        javascript_include_tag 'application', 'data-turbolinks-track' => true
         csrf_meta_tags
       }
       body {
-        yield
+        self << yield
         javascript_include_tag "application"
       }
     }
 
 Everything should work as you would expect.
 
 Set your editor syntax for .gara files to Ruby.
 
+### Helpers
+
+Helpers defined on the view context which return strings will have this strings inserted as markup in the dob.
+
+### Note
+
+When in doubt you may always use the following to insert markup.
+
+    self << something_returning_markup
+
+If you find something is not appearing at all or looking strange in your markup, try this.  For now, it is required for the standard use of yield in the application template when yield is not the last statement in a block.
+
 ## Background
 
 The motivation for this gem is simple.  The bondage of HAML is unnecessary.  The clutter of Erb is unsightly.
 
-I want to reduce cognative load, increase development speed and reduce errors.  I have observed much time is spent in view construction and many errors creep in here.  The seemingly minor irritation of having multiple syntaxes present in a single file contributes to problems.
+I want to reduce cognative load, increase development speed and reduce errors.  To this end I want to keep as much as possible to "one syntax per file".
 
-I want one syntax per file.  With a little imagination Ruby can map to HTML easily using its block structure.  This facilitates construction of an internal DSL that is "Just Ruby."
+With a little imagination Ruby can map to HTML easily using its block structure.  This facilitates construction of an internal DSL that is "Just Ruby."
 
-Ultimately my objective with Gara is to get away from writing HTML directly and to use Gara as a substrate for building pages out of higher-level, reusable components which include not only DOM elements but also behaviors.  This is a key aspect of the AppExpress platform at [appexpress.io](http://appexpress.io).
+Ultimately my objective with Gara is to get away from writing HTML directly and to use this as a substrate for building pages out of higher-level, reusable components which include not only DOM elements but also behaviors.  
+
+This is a key aspect of the AppExpress platform at [appexpress.io](http://appexpress.io).
 
 This project rocks and uses MIT-LICENSE.