docs : copy edits and additions

_posts/demos/2010-12-29-layout-modes.html

@@ -6,9 +6,8 @@ related: layouts
 ---
   
   <section id="copy">
-    
-    <p>Isotope has a versatile layout engine that can accommodate multiple layout modes. See the docs on <a href="../docs/layout-modes.html">layout modes</a>.</p>
-    
+    <p>Isotope has a versatile layout engine that can accommodate multiple layout modes. Vertical layouts react to changes in browser width. Horizontal layouts react to browser height.</p>
+    <p>See docs on <a href="../docs/layout-modes.html">layout modes</a>.</p>
   </section>
   
   <section id="options" class="clearfix">

_posts/demos/2011-01-02-adding-items.html

@@ -8,6 +8,7 @@ related: methods
   <section id="copy">
     <p>The <code>insert</code> method will append, add items to the widget, filter, sort, and then layout all items</p>
     <p>The <code>appended</code> method adds items to the widget, and then lays out only the new items.</p>
+    <p>See docs on <a href="../docs/adding-items.html">adding items</a>.</p>
   </section>
 
   <section id="options">

_posts/docs/2010-12-02-getting-started.mdown

@@ -11,11 +11,31 @@ this is how you get started
 
 Isotope requires jQuery 1.4.3 and greater.
 
+## Markup
+
+Isotope works on a container element with a group of similar child items.
+
+{% highlight html %}
+
+<div id="container">
+  <div class="item">...</div>
+  <div class="item">...</div>
+  <div class="item">...</div>
+  ...
+</div>
+
+{% endhighlight %}
+
+## Script
+
 {% highlight javascript %}
 
 $('#container').isotope({
   // options
-  itemSelector : '.item-class'
+  itemSelector : '.item',
+  layoutMode : 'fitRows'
 });
 
-{% endhighlight %}
+{% endhighlight %}
+
+There are a number of <a href="options.html">options</a> you can specify.  Within the options is where you can <a href="layout-modes.html">set the layout mode</a>, <a href="filtering.html">filter items</a>,  and <a href="sorting.html">sort items</a>.

_posts/docs/2010-12-03-options.mdown

@@ -207,7 +207,7 @@ The style applied to item elements made visible by Filtering.
 
 In addition the general options listed above, certain layout modes each have their own options. In order to avoid conflict, these options are set with an option that matches the name of the layout mode.
 
-See [Layout modes](layout-modes.html) for each layout mode's available options.
+See docs on [layout modes](layout-modes.html) for each layout mode's available options.
 
 For example, if your layout switched from `masonry` to `cellsByRow`:
 

_posts/docs/2010-12-11-troubleshooting.mdown

@@ -0,0 +1,12 @@
+---
+
+title: Troubleshooting
+category: docs
+layout: doc
+related: etc
+
+---
+
+## Images
+
+Most layout modes (i.e masonry, fitRows) need to measure the size of each item before 

css/style.css

@@ -11,7 +11,7 @@ body {
   font-family: 'Helvetica Neue', Arial, sans-serif;
   font-size: 13px;
   line-height: 1.7em;
-  background: #222;
+  background: #262222;
   color: #FFF;
 }