     :index         - Name of a secondary index to query.
     :order         - Index scaning order e/o #{:asc :desc}.
     :limit         - Max num >=1 of items to eval (≠ num of matching items).
+                     Useful to prevent harmful sudden bursts of read activity.
     :consistent?   - Use strongly (rather than eventually) consistent reads?
 
   comparison-operators e/o #{:eq :le :lt :ge :gt :begins-with :between}.
 
-  For unindexed item retrievel see `scan`."
+  For unindexed item retrievel see `scan`.
+
+  Ref. http://goo.gl/XfGKW for query+scan best practices."
   [creds table prim-key-conds
    & [{:keys [last-prim-kvs max-reqs return index order limit consistent?
               return-cc?] :as opts

(defn- merge-more
  "Enables auto paging for batch batch-get/write and query/scan requests.
  Particularly useful for throughput limitations."
  [more-f max-idx last-result]
  (loop [{:keys [unprocessed last-prim-kvs] :as last-result} last-result idx 1]
    (let [more (or unprocessed last-prim-kvs)]

  "Retrieves items from a table (unindexed) with options:
    :attr-conds     - {<attr> [<comparison-operator> <values>] ...}.
    :limit          - Max num >=1 of items to eval (≠ num of matching items).
                      Useful to prevent harmful sudden bursts of read activity.
    :last-prim-kvs  - Primary key-val from which to eval, useful for paging.
    :max-reqs       - Max number of requests to automatically stitch together.
    :return         - e/o #{:all-attributes :all-projected-attributes :count
