docs(query): improve find() docs re: #7188

lib/query.js

@@ -1759,15 +1759,17 @@ Query.prototype._find = function(callback) {
 };
 
 /**
- * Finds documents.
- *
- * When no `callback` is passed, the query is not executed. When the query is executed, the result will be an array of documents.
+ * Find all documents that match `selector`. The result will be an array of documents.
  *
  * ####Example
  *
- *     query.find({ name: 'Los Pollos Hermanos' }).find(callback)
+ *     // Using async/await
+ *     const arr = await Movie.find({ year: { $gte: 1980, $lte: 1989 } });
  *
- * @param {Object} [filter] mongodb selector
+ *     // Using callbacks
+ *     Movie.find({ year: { $gte: 1980, $lte: 1989 } }, function(err, arr) {});
+ *
+ * @param {Object} [filter] mongodb selector. If not specified, returns all documents.
  * @param {Function} [callback]
  * @return {Query} this
  * @api public