Merge pull request #322 from justindell/where-with-ranges-fix

Correct endless range example and provide some clarity

Author: koic

README.adoc

@@ -1061,21 +1061,26 @@ Use ranges instead of defining comparative conditions using a template for scala
 [source,ruby]
 ----
 # bad
-User.where("created_at > ?", 30.days.ago).where("created_at < ?", 7.days.ago)
-User.where("created_at > ? AND created_at < ?", 30.days.ago, 7.days.ago)
-User.where("created_at > :start AND created_at < end", start: 30.days.ago, end: 7.days.ago)
+User.where("created_at >= ?", 30.days.ago).where("created_at <= ?", 7.days.ago)
+User.where("created_at >= ? AND created_at <= ?", 30.days.ago, 7.days.ago)
+User.where("created_at >= :start AND created_at <= :end", start: 30.days.ago, end: 7.days.ago)
 
 # good
 User.where(created_at: 30.days.ago..7.days.ago)
 
 # bad
-User.where("created_at > ?", 7.days.ago)
+User.where("created_at >= ?", 7.days.ago)
 
 # good
 User.where(created_at: 7.days.ago..)
 
-# okish - there is no range syntax that would denote inclusion on one end and
-# exclusion on another.
+# note - ranges are inclusive or exclusive of their ending, not beginning
+User.where(created_at: 7.days.ago..)  # produces >=
+User.where(created_at: 7.days.ago...) # also produces >=
+User.where(created_at: ..7.days.ago)  # inclusive: produces <=
+User.where(created_at: ...7.days.ago) # exclusive: produces <
+
+# okish - there is no range syntax that would denote exclusion at the beginning of the range
 Customer.where("purchases_count > :min AND purchases_count <= :max", min: 0, max: 5)
 ----