Warning not to invoke background m.request as m.prop in modules

archive/v0.1/getting-started.html

@@ -81,16 +81,16 @@ todo.Todo = function(data) {
 todo.TodoList = Array;</code></pre>
 <p><a href="mithril.prop.html"><code>m.prop</code></a> is simply a factory for a getter-setter function. Getter-setters work like this:</p>
 <pre><code class="lang-javascript">//define a getter-setter with initial value `John`
-var name = m.prop(&quot;John&quot;);
+var firstName = m.prop(&quot;John&quot;);
 
 //read the value
-var a = name(); //a == &quot;John&quot;
+var a = firstName(); //a == &quot;John&quot;
 
 //set the value to `Mary`
-name(&quot;Mary&quot;); //Mary
+firstName(&quot;Mary&quot;); //Mary
 
 //read the value
-var b = name(); //b == &quot;Mary&quot;</code></pre>
+var b = firstName(); //b == &quot;Mary&quot;</code></pre>
 <p>Note that the <code>Todo</code> and <code>TodoList</code> classes we defined above are plain vanilla Javascript constructors. They can be initialized and used like this:</p>
 <pre><code class="lang-javascript">var myTask = new todo.Todo({description: &quot;Write code&quot;});
 

archive/v0.1/mithril.prop.html

@@ -64,16 +64,16 @@
 <hr>
 <h3 id="usage">Usage</h3>
 <pre><code class="lang-javascript">//define a getter-setter with initial value `John`
-var name = m.prop(&quot;John&quot;);
+var firstName = m.prop(&quot;John&quot;);
 
 //read the value
-var a = name(); //a == &quot;John&quot;
+var a = firstName(); //a == &quot;John&quot;
 
 //set the value to `Mary`
-name(&quot;Mary&quot;); //Mary
+firstName(&quot;Mary&quot;); //Mary
 
 //read the value
-var b = name(); //b == &quot;Mary&quot;</code></pre>
+var b = firstName(); //b == &quot;Mary&quot;</code></pre>
 <p>It can be used in conjunction with <a href="mithril.withattr.html"><code>m.withAttr</code></a> to implement data binding in the view-to-model direction and to provide uniform data access for model entity properties.</p>
 <pre><code class="lang-javascript">//a contrived example of bi-directional data binding
 var user = {

docs/mithril.request.md

@@ -458,6 +458,8 @@ where:
 			.then(m.redraw); //force redraw
 		```
 
+		The return value of a background `m.request` should not be exposed to controllers or views, since without the blocking effect of redraw-blocking effect of `m.startComputation` it is liable to be invoked before it resolves, which can lead to runtime errors.
+		
 	-	**any unwrapSuccess(any data)** (optional)
 
 		A preprocessor function to unwrap the data from a success response in case the response contains metadata wrapping the data.