better comments

Author: scottinet

src/kuzzleDataCollection.js

@@ -298,7 +298,7 @@ KuzzleDataCollection.prototype.fetchAllDocuments = function (options, cb) {
     if (searchResult instanceof KuzzleSearchResult) {
       if (searchResult.total > 10000 && !warnEmitted) {
         warnEmitted = true;
-        console.warn('Usage of KuzzleDataCollection.fetchAllDocuments will fetch more than 10 000 document. To avoid performance issues, please use KuzzleDataCollection.search and KuzzleDataCollection.scroll requests')
+        console.warn('KuzzleDataCollection.fetchAllDocuments may return extremely large amounts of documents, which may cause performance issues. Unless you know what you are doing, consider using KuzzleDataCollection.search or KuzzleDataCollection.scroll instead')
       }
 
       searchResult.documents.forEach(document => {
@@ -460,7 +460,10 @@ KuzzleDataCollection.prototype.search = function (filters, options, cb) {
 };
 
 /**
- * Scroll into a search result
+ * A "scroll" option can be passed to search queries, creating persistent
+ * paginated results.
+ * This method can be used to manually get the next page of a search result,
+ * instead of using KuzzleSearchResult.next()
  *
  * @param {string} scrollId
  * @param {object} [options]