0
@@ -39,12 +39,16 @@ module WillPaginate
0
     #
0
     # == The importance of the <tt>:order</tt> parameter
0
     #
0
-    # In ActiveRecord finders, <tt>:order</tt> parameter specifies columns for the
0
-    # <tt>ORDER BY</tt> clause in SQL. It is important to have it, since pagination only makes
0
-    # sense with ordered sets. Without the <tt>ORDER BY</tt> clause, databases aren't required
0
-    # to do consistent ordering when performing <tt>SELECT</tt> queries; this is especially true
0
-    # for PostgreSQL.
0
-    # 
0
+    # In ActiveRecord finders, <tt>:order</tt> parameter specifies columns for
0
+    # the <tt>ORDER BY</tt> clause in SQL. It is important to have it, since
0
+    # pagination only makes sense with ordered sets. Without the <tt>ORDER
0
+    # BY</tt> clause, databases aren't required to do consistent ordering when
0
+    # performing <tt>SELECT</tt> queries; this is especially true for
0
+    # PostgreSQL.
0
+    #
0
+    # Therefore, make sure you are doing ordering on a column that makes the
0
+    # most sense in the current context. Make that obvious to the user, also.
0
+    # For perfomance reasons you will also want to add an index to that column.
0
     module ClassMethods
0
       # This is the main paginating finder.
0
       #