From 06a150627d98de9f7c75a80be41ae3a2928c2f21 Mon Sep 17 00:00:00 2001
From: Jeremy Ashkenas <jashkenas@gmail.com>
Date: Wed, 8 Dec 2010 11:28:29 -0500
Subject: [PATCH] Adding FAQ section for bootstrapping

---
 index.html | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/index.html b/index.html
index df6000f3..dbb3d5a4 100644
--- a/index.html
+++ b/index.html
@@ -269,6 +269,7 @@
     <ul class="toc_section">
       <li>– <a href="#FAQ-events">Catalog of Events</a></li>
       <li>– <a href="#FAQ-nested">Nested Models &amp; Collections</a></li>
+      <li>– <a href="#FAQ-bootstrap">Loading Bootstrapped Models</a></li>
       <li>– <a href="#FAQ-mvc">Traditional MVC</a></li>
       <li>– <a href="#FAQ-this">Binding "this"</a></li>
       <li>- <a href="#FAQ-rias">Other RIA Frameworks</a></li>
@@ -1873,6 +1874,26 @@ var Inbox = new Mailbox;
 // And then, when the Inbox is opened:
 
 Inbox.messages.fetch();
+</pre>
+
+    <p id="FAQ-bootstrap">
+      <b class="header">Loading Bootstrapped Models</b>
+      <br />
+      When your app first loads, it's common to have a set of initial models that
+      you know you're going to need, in order to render the page. Instead of 
+      firing an extra AJAX request to <a href="#Collection-fetch">fetch</a> them,
+      a nicer pattern is to have their data already bootstrapped into the page.
+      You can then use <a href="#Collection-refresh">refresh</a> to populate your
+      collections with the initial data. At DocumentCloud, in the 
+      <a href="http://en.wikipedia.org/wiki/ERuby">ERB</a> template for the 
+      workspace, we do something along these lines:
+    </p>
+
+<pre>
+&lt;script&gt;
+  Accounts.refresh(&lt;%= @accounts.to_json %&gt;);
+  Projects.refresh(&lt;%= @projects.to_json(:collaborators => true) %&gt;);
+&lt;/script&gt;
 </pre>
 
     <p id="FAQ-mvc">