Update pages. See main branch for changes

Author: johnny

README.mkd

@@ -1,11 +1,18 @@
 # jQuery Sortable
 
-jQuery Sortable is a flexible, opinionated sorting plugin. Its aim is to do one thing: sorting
+jQuery Sortable is a flexible, opinionated sorting plugin.
+It enables items in a list (or table etc.) to be sorted horizontally and vertically using the mouse.
+Supports nested lists and pure drag/drop containers.
+
+jQuery Sortable does not depend on jQuery UI and works well with Twitter's Bootstrap (You can even sort the Bootstrap navigation).
+
+More information can be found on [http://johnny.github.com/jquery-sortable/](http://johnny.github.com/jquery-sortable/).
 
 ## Dependencies
 
-jquery
+jquery (>= 1.7.0)
 
 ## Development Dependencies
 
-See the Gemfile
+jQuery Sortable is developed using [middleman](http://middlemanapp.com/).
+A **bundle install** shoud pull in everything needed.

index.html

@@ -123,8 +123,8 @@ <h3>The opinionated part</h3>
         .
       </p>
       <p>
-        Moreover this plugin assumes, that the placeholder has zero height/width.
-        This way we can cache the item dimensions.
+        Moreover this plugin assumes that the placeholder has zero height/width.
+        As a result, the item dimensions may be cached.
         <small>This might change in the future, if need be.</small>
       </p>
       <h3>Compatibility</h3>
@@ -152,6 +152,11 @@ <h3>
           With default options.
         </small>
       </h3>
+      <p>
+        <span class='label label-info'>Heads Up!</span>
+        There is no on-the-fly creation of sublists.
+        Only list items that contain a sublist are drop targets.
+      </p>
       <ol class='default vertical'>
         <li>First</li>
         <li>Second</li>
@@ -314,6 +319,7 @@ <h2>Sort handle and limited drag/drop</h2>
   <span class="key">group</span>: <span class="string"><span class="delimiter">'</span><span class="content">no-drop</span><span class="delimiter">'</span></span>,
   <span class="key">handle</span>: <span class="string"><span class="delimiter">'</span><span class="content">i.icon-move</span><span class="delimiter">'</span></span>,
   <span class="function">onDragStart</span>: <span class="keyword">function</span> (item, container, _super) {
+    <span class="comment">// Duplicate items of the no drop area</span>
     <span class="keyword">if</span>(!container.options.drop)
       item.clone().insertAfter(item)
     _super(item)

js/application.js

@@ -1646,6 +1646,7 @@ $(function() {
     group: 'no-drop',
     handle: 'i.icon-move',
     onDragStart: function (item, container, _super) {
+      // Duplicate items of the no drop area
       if(!container.options.drop)
         item.clone().insertAfter(item)
       _super(item)

js/examples/simple_with_no_drop.js

@@ -3,6 +3,7 @@ $(function() {
     group: 'no-drop',
     handle: 'i.icon-move',
     onDragStart: function (item, container, _super) {
+      // Duplicate items of the no drop area
       if(!container.options.drop)
         item.clone().insertAfter(item)
       _super(item)