mongoose 6.9.0 → 6.9.2

package/lib/query.js

@@ -70,7 +70,7 @@ const queryOptionMethods = new Set([
 /**
  * Query constructor used for building queries. You do not need
  * to instantiate a `Query` directly. Instead use Model functions like
- * [`Model.find()`](/docs/api/find.html#find_find).
+ * [`Model.find()`](/docs/api/model.html#model_Model-find).
  *
  * #### Example:
  *
@@ -166,7 +166,7 @@ Query.base = mquery.prototype;
  *
  * MongoDB 2.4 deprecated the use of `$within`, replacing it with `$geoWithin`. Mongoose uses `$geoWithin` by default (which is 100% backward compatible with `$within`). If you are running an older version of MongoDB, set this flag to `false` so your `within()` queries continue to work.
  *
- * @see geoWithin https://docs.mongodb.org/manual/reference/operator/geoWithin/
+ * @see geoWithin https://www.mongodb.com/docs/manual/reference/operator/geoWithin/
  * @default true
  * @property use$geoWithin
  * @memberOf Query
@@ -323,9 +323,9 @@ Query.prototype.clone = function clone() {
  * #### Note:
  *
  * Only use `$where` when you have a condition that cannot be met using other MongoDB operators like `$lt`.
- * **Be sure to read about all of [its caveats](https://docs.mongodb.org/manual/reference/operator/where/) before using.**
+ * **Be sure to read about all of [its caveats](https://www.mongodb.com/docs/manual/reference/operator/where/) before using.**
  *
- * @see $where https://docs.mongodb.org/manual/reference/operator/where/
+ * @see $where https://www.mongodb.com/docs/manual/reference/operator/where/
  * @method $where
  * @param {String|Function} js javascript string or function
  * @return {Query} this
@@ -398,8 +398,8 @@ Query.prototype.clone = function clone() {
  * @param {String} [path]
  * @param {Number|Array} val number of elements to slice or array with number of elements to skip and number of elements to slice
  * @return {Query} this
- * @see mongodb https://www.mongodb.org/display/DOCS/Retrieving+a+Subset+of+Fields#RetrievingaSubsetofFields-RetrievingaSubrangeofArrayElements
- * @see $slice https://docs.mongodb.org/manual/reference/projection/slice/#prj._S_slice
+ * @see mongodb https://www.mongodb.com/docs/manual/tutorial/query-documents/#projection
+ * @see $slice https://www.mongodb.com/docs/manual/reference/projection/slice/#prj._S_slice
  * @api public
  */
 
@@ -485,7 +485,7 @@ Query.prototype._validateOp = function() {
  *
  *     query.or([{ color: 'red' }, { status: 'emergency' }]);
  *
- * @see $or https://docs.mongodb.org/manual/reference/operator/or/
+ * @see $or https://www.mongodb.com/docs/manual/reference/operator/or/
  * @method or
  * @memberOf Query
  * @instance
@@ -501,7 +501,7 @@ Query.prototype._validateOp = function() {
  *
  *     query.nor([{ color: 'green' }, { status: 'ok' }]);
  *
- * @see $nor https://docs.mongodb.org/manual/reference/operator/nor/
+ * @see $nor https://www.mongodb.com/docs/manual/reference/operator/nor/
  * @method nor
  * @memberOf Query
  * @instance
@@ -520,7 +520,7 @@ Query.prototype._validateOp = function() {
  * @method and
  * @memberOf Query
  * @instance
- * @see $and https://docs.mongodb.org/manual/reference/operator/and/
+ * @see $and https://www.mongodb.com/docs/manual/reference/operator/and/
  * @param {Array} array array of conditions
  * @return {Query} this
  * @api public
@@ -543,7 +543,7 @@ Query.prototype._validateOp = function() {
  * @instance
  * @param {String} [path]
  * @param {Number} val
- * @see $gt https://docs.mongodb.org/manual/reference/operator/gt/
+ * @see $gt https://www.mongodb.com/docs/manual/reference/operator/gt/
  * @api public
  */
 
@@ -557,7 +557,7 @@ Query.prototype._validateOp = function() {
  * @instance
  * @param {String} [path]
  * @param {Number} val
- * @see $gte https://docs.mongodb.org/manual/reference/operator/gte/
+ * @see $gte https://www.mongodb.com/docs/manual/reference/operator/gte/
  * @api public
  */
 
@@ -571,7 +571,7 @@ Query.prototype._validateOp = function() {
  * @instance
  * @param {String} [path]
  * @param {Number} val
- * @see $lt https://docs.mongodb.org/manual/reference/operator/lt/
+ * @see $lt https://www.mongodb.com/docs/manual/reference/operator/lt/
  * @api public
  */
 
@@ -581,7 +581,7 @@ Query.prototype._validateOp = function() {
  * When called with one argument, the most recent path passed to `where()` is used.
  *
  * @method lte
- * @see $lte https://docs.mongodb.org/manual/reference/operator/lte/
+ * @see $lte https://www.mongodb.com/docs/manual/reference/operator/lte/
  * @memberOf Query
  * @instance
  * @param {String} [path]
@@ -594,7 +594,7 @@ Query.prototype._validateOp = function() {
  *
  * When called with one argument, the most recent path passed to `where()` is used.
  *
- * @see $ne https://docs.mongodb.org/manual/reference/operator/ne/
+ * @see $ne https://www.mongodb.com/docs/manual/reference/operator/ne/
  * @method ne
  * @memberOf Query
  * @instance
@@ -608,7 +608,7 @@ Query.prototype._validateOp = function() {
  *
  * When called with one argument, the most recent path passed to `where()` is used.
  *
- * @see $in https://docs.mongodb.org/manual/reference/operator/in/
+ * @see $in https://www.mongodb.com/docs/manual/reference/operator/in/
  * @method in
  * @memberOf Query
  * @instance
@@ -622,7 +622,7 @@ Query.prototype._validateOp = function() {
  *
  * When called with one argument, the most recent path passed to `where()` is used.
  *
- * @see $nin https://docs.mongodb.org/manual/reference/operator/nin/
+ * @see $nin https://www.mongodb.com/docs/manual/reference/operator/nin/
  * @method nin
  * @memberOf Query
  * @instance
@@ -642,7 +642,7 @@ Query.prototype._validateOp = function() {
  *     // Equivalent:
  *     MyModel.find().all('pets', ['dog', 'cat', 'ferret']);
  *
- * @see $all https://docs.mongodb.org/manual/reference/operator/all/
+ * @see $all https://www.mongodb.com/docs/manual/reference/operator/all/
  * @method all
  * @memberOf Query
  * @instance
@@ -662,7 +662,7 @@ Query.prototype._validateOp = function() {
  *     assert(Array.isArray(docs));
  *     console.log('documents with 0 tags', docs);
  *
- * @see $size https://docs.mongodb.org/manual/reference/operator/size/
+ * @see $size https://www.mongodb.com/docs/manual/reference/operator/size/
  * @method size
  * @memberOf Query
  * @instance
@@ -676,7 +676,7 @@ Query.prototype._validateOp = function() {
  *
  * When called with one argument, the most recent path passed to `where()` is used.
  *
- * @see $regex https://docs.mongodb.org/manual/reference/operator/regex/
+ * @see $regex https://www.mongodb.com/docs/manual/reference/operator/regex/
  * @method regex
  * @memberOf Query
  * @instance
@@ -690,7 +690,7 @@ Query.prototype._validateOp = function() {
  *
  * When called with one argument, the most recent path passed to `where()` is used.
  *
- * @see $maxDistance https://docs.mongodb.org/manual/reference/operator/maxDistance/
+ * @see $maxDistance https://www.mongodb.com/docs/manual/reference/operator/maxDistance/
  * @method maxDistance
  * @memberOf Query
  * @instance
@@ -717,7 +717,7 @@ Query.prototype._validateOp = function() {
  * @param {String} [path]
  * @param {Array} val must be of length 2, first element is `divisor`, 2nd element is `remainder`.
  * @return {Query} this
- * @see $mod https://docs.mongodb.org/manual/reference/operator/mod/
+ * @see $mod https://www.mongodb.com/docs/manual/reference/operator/mod/
  * @api public
  */
 
@@ -766,7 +766,7 @@ Query.prototype.mod = function() {
  * @param {String} [path]
  * @param {Boolean} val
  * @return {Query} this
- * @see $exists https://docs.mongodb.org/manual/reference/operator/exists/
+ * @see $exists https://www.mongodb.com/docs/manual/reference/operator/exists/
  * @api public
  */
 
@@ -795,7 +795,7 @@ Query.prototype.mod = function() {
  * @param {String|Object|Function} path
  * @param {Object|Function} filter
  * @return {Query} this
- * @see $elemMatch https://docs.mongodb.org/manual/reference/operator/elemMatch/
+ * @see $elemMatch https://www.mongodb.com/docs/manual/reference/operator/elemMatch/
  * @api public
  */
 
@@ -827,11 +827,11 @@ Query.prototype.mod = function() {
  * In Mongoose 3.7, `within` changed from a getter to a function. If you need the old syntax, use [this](https://github.com/ebensing/mongoose-within).
  *
  * @method within
- * @see $polygon https://docs.mongodb.org/manual/reference/operator/polygon/
- * @see $box https://docs.mongodb.org/manual/reference/operator/box/
- * @see $geometry https://docs.mongodb.org/manual/reference/operator/geometry/
- * @see $center https://docs.mongodb.org/manual/reference/operator/center/
- * @see $centerSphere https://docs.mongodb.org/manual/reference/operator/centerSphere/
+ * @see $polygon https://www.mongodb.com/docs/manual/reference/operator/polygon/
+ * @see $box https://www.mongodb.com/docs/manual/reference/operator/box/
+ * @see $geometry https://www.mongodb.com/docs/manual/reference/operator/geometry/
+ * @see $center https://www.mongodb.com/docs/manual/reference/operator/center/
+ * @see $centerSphere https://www.mongodb.com/docs/manual/reference/operator/centerSphere/
  * @memberOf Query
  * @instance
  * @return {Query} this
@@ -886,7 +886,7 @@ Query.prototype.limit = function limit(v) {
  * @memberOf Query
  * @instance
  * @param {Number} val
- * @see cursor.skip https://docs.mongodb.org/manual/reference/method/cursor.skip/
+ * @see cursor.skip https://www.mongodb.com/docs/manual/reference/method/cursor.skip/
  * @api public
  */
 
@@ -920,7 +920,7 @@ Query.prototype.skip = function skip(v) {
  * @memberOf Query
  * @instance
  * @param {Number} val
- * @see maxScan https://docs.mongodb.org/manual/reference/operator/maxScan/
+ * @see maxScan https://www.mongodb.com/docs/v4.0/reference/method/cursor.maxScan/
  * @api public
  */
 
@@ -939,7 +939,7 @@ Query.prototype.skip = function skip(v) {
  * @memberOf Query
  * @instance
  * @param {Number} val
- * @see batchSize https://docs.mongodb.org/manual/reference/method/cursor.batchSize/
+ * @see batchSize https://www.mongodb.com/docs/manual/reference/method/cursor.batchSize/
  * @api public
  */
 
@@ -958,7 +958,7 @@ Query.prototype.skip = function skip(v) {
  * @memberOf Query
  * @instance
  * @param {String} val
- * @see comment https://docs.mongodb.org/manual/reference/operator/comment/
+ * @see comment https://www.mongodb.com/docs/manual/reference/operator/comment/
  * @api public
  */
 
@@ -978,7 +978,6 @@ Query.prototype.skip = function skip(v) {
  * @method snapshot
  * @memberOf Query
  * @instance
- * @see snapshot https://docs.mongodb.org/manual/reference/operator/snapshot/
  * @return {Query} this
  * @api public
  */
@@ -999,7 +998,7 @@ Query.prototype.skip = function skip(v) {
  * @instance
  * @param {Object} val a hint object
  * @return {Query} this
- * @see $hint https://docs.mongodb.org/manual/reference/operator/hint/
+ * @see $hint https://www.mongodb.com/docs/manual/reference/operator/hint/
  * @api public
  */
 
@@ -1051,7 +1050,7 @@ Query.prototype.projection = function(arg) {
  *
  * A projection _must_ be either inclusive or exclusive. In other words, you must
  * either list the fields to include (which excludes all others), or list the fields
- * to exclude (which implies all other fields are included). The [`_id` field is the only exception because MongoDB includes it by default](https://docs.mongodb.com/manual/tutorial/project-fields-from-query-results/#suppress-id-field).
+ * to exclude (which implies all other fields are included). The [`_id` field is the only exception because MongoDB includes it by default](https://www.mongodb.com/docs/manual/tutorial/project-fields-from-query-results/#suppress-id-field).
  *
  * #### Example:
  *
@@ -1088,7 +1087,7 @@ Query.prototype.projection = function(arg) {
  * @instance
  * @param {Object|String|String[]} arg
  * @return {Query} this
- * @see SchemaType /docs/api/schematype
+ * @see SchemaType /docs/api/schematype.html
  * @api public
  */
 
@@ -1207,14 +1206,14 @@ Query.prototype.select = function select() {
  *     // read from secondaries with matching tags
  *     new Query().read('s', [{ dc:'sf', s: 1 },{ dc:'ma', s: 2 }])
  *
- * Read more about how to use read preferences [here](https://docs.mongodb.org/manual/applications/replication/#read-preference).
+ * Read more about how to use read preferences [here](https://www.mongodb.com/docs/manual/applications/replication/#read-preference).
  *
  * @method read
  * @memberOf Query
  * @instance
  * @param {String} pref one of the listed preference options or aliases
  * @param {Array} [tags] optional tags for this query
- * @see mongodb https://docs.mongodb.org/manual/applications/replication/#read-preference
+ * @see mongodb https://www.mongodb.com/docs/manual/applications/replication/#read-preference
  * @return {Query} this
  * @api public
  */
@@ -1264,7 +1263,7 @@ Query.prototype.toString = function toString() {
 };
 
 /**
- * Sets the [MongoDB session](https://docs.mongodb.com/manual/reference/server-sessions/)
+ * Sets the [MongoDB session](https://www.mongodb.com/docs/manual/reference/server-sessions/)
  * associated with this query. Sessions are how you mark a query as part of a
  * [transaction](/docs/transactions.html).
  *
@@ -1298,7 +1297,7 @@ Query.prototype.session = function session(v) {
  *
  * - `w`: Sets the specified number of `mongod` servers, or tag set of `mongod` servers, that must acknowledge this write before this write is considered successful.
  * - `j`: Boolean, set to `true` to request acknowledgement that this operation has been persisted to MongoDB's on-disk journal.
- * - `wtimeout`: If [`w > 1`](/docs/api/query.html#query_Query-w), the maximum amount of time to wait for this write to propagate through the replica set before this operation fails. The default is `0`, which means no timeout.
+ * - `wtimeout`: If [`w > 1`](#query_Query-w), the maximum amount of time to wait for this write to propagate through the replica set before this operation fails. The default is `0`, which means no timeout.
  *
  * This option is only valid for operations that write to the database:
  *
@@ -1368,8 +1367,8 @@ Query.prototype.writeConcern = function writeConcern(val) {
  * @method w
  * @memberOf Query
  * @instance
- * @param {String|number} val 0 for fire-and-forget, 1 for acknowledged by one server, 'majority' for majority of the replica set, or [any of the more advanced options](https://docs.mongodb.com/manual/reference/write-concern/#w-option).
- * @see mongodb https://docs.mongodb.com/manual/reference/write-concern/#w-option
+ * @param {String|number} val 0 for fire-and-forget, 1 for acknowledged by one server, 'majority' for majority of the replica set, or [any of the more advanced options](https://www.mongodb.com/docs/manual/reference/write-concern/#w-option).
+ * @see mongodb https://www.mongodb.com/docs/manual/reference/write-concern/#w-option
  * @return {Query} this
  * @api public
  */
@@ -1411,7 +1410,7 @@ Query.prototype.w = function w(val) {
  * @memberOf Query
  * @instance
  * @param {boolean} val
- * @see mongodb https://docs.mongodb.com/manual/reference/write-concern/#j-option
+ * @see mongodb https://www.mongodb.com/docs/manual/reference/write-concern/#j-option
  * @return {Query} this
  * @api public
  */
@@ -1429,7 +1428,7 @@ Query.prototype.j = function j(val) {
 };
 
 /**
- * If [`w > 1`](/docs/api/query.html#query_Query-w), the maximum amount of time to
+ * If [`w > 1`](#query_Query-w), the maximum amount of time to
  * wait for this write to propagate through the replica set before this
  * operation fails. The default is `0`, which means no timeout.
  *
@@ -1461,7 +1460,7 @@ Query.prototype.j = function j(val) {
  * @memberOf Query
  * @instance
  * @param {number} ms number of milliseconds to wait
- * @see mongodb https://docs.mongodb.com/manual/reference/write-concern/#wtimeout
+ * @see mongodb https://www.mongodb.com/docs/manual/reference/write-concern/#wtimeout
  * @return {Query} this
  * @api public
  */
@@ -1519,12 +1518,12 @@ Query.prototype.wtimeout = function wtimeout(ms) {
  * s   snapshot
  * ```
  *
- * Read more about how to use read concern [here](https://docs.mongodb.com/manual/reference/read-concern/).
+ * Read more about how to use read concern [here](https://www.mongodb.com/docs/manual/reference/read-concern/).
  *
  * @memberOf Query
  * @method readConcern
  * @param {String} level one of the listed read concern level or their aliases
- * @see mongodb https://docs.mongodb.com/manual/reference/read-concern/
+ * @see mongodb https://www.mongodb.com/docs/manual/reference/read-concern/
  * @return {Query} this
  * @api public
  */
@@ -1554,35 +1553,35 @@ Query.prototype.getOptions = function() {
  *
  * The following options are only for `find()`:
  *
- * - [tailable](https://www.mongodb.org/display/DOCS/Tailable+Cursors)
- * - [sort](https://www.mongodb.org/display/DOCS/Advanced+Queries#AdvancedQueries-%7B%7Bsort(\)%7D%7D)
- * - [limit](https://www.mongodb.org/display/DOCS/Advanced+Queries#AdvancedQueries-%7B%7Blimit%28%29%7D%7D)
- * - [skip](https://www.mongodb.org/display/DOCS/Advanced+Queries#AdvancedQueries-%7B%7Bskip%28%29%7D%7D)
- * - [allowDiskUse](https://docs.mongodb.com/manual/reference/method/cursor.allowDiskUse/)
- * - [batchSize](https://www.mongodb.org/display/DOCS/Advanced+Queries#AdvancedQueries-%7B%7BbatchSize%28%29%7D%7D)
- * - [readPreference](https://docs.mongodb.org/manual/applications/replication/#read-preference)
- * - [hint](https://www.mongodb.org/display/DOCS/Advanced+Queries#AdvancedQueries-%24hint)
- * - [comment](https://www.mongodb.org/display/DOCS/Advanced+Queries#AdvancedQueries-%24comment)
- * - [snapshot](https://www.mongodb.org/display/DOCS/Advanced+Queries#AdvancedQueries-%7B%7Bsnapshot%28%29%7D%7D)
- * - [maxscan](https://docs.mongodb.org/v3.2/reference/operator/meta/maxScan/#metaOp._S_maxScan)
+ * - [tailable](https://www.mongodb.com/docs/manual/core/tailable-cursors/)
+ * - [sort](https://www.mongodb.com/docs/manual/reference/method/cursor.sort/)
+ * - [limit](https://www.mongodb.com/docs/manual/reference/method/cursor.limit/)
+ * - [skip](https://www.mongodb.com/docs/manual/reference/method/cursor.skip/)
+ * - [allowDiskUse](https://www.mongodb.com/docs/manual/reference/method/cursor.allowDiskUse/)
+ * - [batchSize](https://www.mongodb.com/docs/manual/reference/method/cursor.batchSize/)
+ * - [readPreference](https://www.mongodb.com/docs/manual/applications/replication/#read-preference)
+ * - [hint](https://www.mongodb.com/docs/manual/reference/method/cursor.hint/)
+ * - [comment](https://www.mongodb.com/docs/manual/reference/method/cursor.comment/)
+ * - snapshot
+ * - [maxscan](https://www.mongodb.com/docs/v4.0/reference/method/cursor.maxScan/)
  *
  * The following options are only for write operations: `update()`, `updateOne()`, `updateMany()`, `replaceOne()`, `findOneAndUpdate()`, and `findByIdAndUpdate()`:
  *
- * - [upsert](https://docs.mongodb.com/manual/reference/method/db.collection.update/)
- * - [writeConcern](https://docs.mongodb.com/manual/reference/method/db.collection.update/)
+ * - [upsert](https://www.mongodb.com/docs/manual/reference/method/db.collection.update/)
+ * - [writeConcern](https://www.mongodb.com/docs/manual/reference/method/db.collection.update/)
  * - [timestamps](https://mongoosejs.com/docs/guide.html#timestamps): If `timestamps` is set in the schema, set this option to `false` to skip timestamps for that particular update. Has no effect if `timestamps` is not enabled in the schema options.
  * - overwriteDiscriminatorKey: allow setting the discriminator key in the update. Will use the correct discriminator schema if the update changes the discriminator key.
  *
  * The following options are only for `find()`, `findOne()`, `findById()`, `findOneAndUpdate()`, and `findByIdAndUpdate()`:
  *
- * - [lean](./api/query.html#query_Query-lean)
+ * - [lean](#query_Query-lean)
  * - [populate](/docs/populate.html)
- * - [projection](/docs/api/query.html#query_Query-projection)
+ * - [projection](#query_Query-projection)
  * - sanitizeProjection
  *
  * The following options are only for all operations **except** `update()`, `updateOne()`, `updateMany()`, `remove()`, `deleteOne()`, and `deleteMany()`:
  *
- * - [maxTimeMS](https://docs.mongodb.com/manual/reference/operator/meta/maxTimeMS/)
+ * - [maxTimeMS](https://www.mongodb.com/docs/manual/reference/operator/meta/maxTimeMS/)
  *
  * The following options are for `findOneAndUpdate()` and `findOneAndRemove()`
  *
@@ -1591,9 +1590,9 @@ Query.prototype.getOptions = function() {
  * The following options are for all operations:
  *
  * - [strict](/docs/guide.html#strict)
- * - [collation](https://docs.mongodb.com/manual/reference/collation/)
- * - [session](https://docs.mongodb.com/manual/reference/server-sessions/)
- * - [explain](https://docs.mongodb.com/manual/reference/method/cursor.explain/)
+ * - [collation](https://www.mongodb.com/docs/manual/reference/collation/)
+ * - [session](https://www.mongodb.com/docs/manual/reference/server-sessions/)
+ * - [explain](https://www.mongodb.com/docs/manual/reference/method/cursor.explain/)
  *
  * @param {Object} options
  * @return {Query} this
@@ -1690,7 +1689,7 @@ Query.prototype.setOptions = function(options, overwrite) {
 };
 
 /**
- * Sets the [`explain` option](https://docs.mongodb.com/manual/reference/method/cursor.explain/),
+ * Sets the [`explain` option](https://www.mongodb.com/docs/manual/reference/method/cursor.explain/),
  * which makes this query return detailed execution stats instead of the actual
  * query result. This method is useful for determining what index your queries
  * use.
@@ -1720,7 +1719,7 @@ Query.prototype.explain = function(verbose) {
 };
 
 /**
- * Sets the [`allowDiskUse` option](https://docs.mongodb.com/manual/reference/method/cursor.allowDiskUse/),
+ * Sets the [`allowDiskUse` option](https://www.mongodb.com/docs/manual/reference/method/cursor.allowDiskUse/),
  * which allows the MongoDB server to use more than 100 MB for this query's `sort()`. This option can
  * let you work around `QueryExceededMemoryLimitNoDiskUseAllowed` errors from the MongoDB server.
  *
@@ -1752,7 +1751,7 @@ Query.prototype.allowDiskUse = function(v) {
 };
 
 /**
- * Sets the [maxTimeMS](https://docs.mongodb.com/manual/reference/method/cursor.maxTimeMS/)
+ * Sets the [maxTimeMS](https://www.mongodb.com/docs/manual/reference/method/cursor.maxTimeMS/)
  * option. This will tell the MongoDB server to abort if the query or write op
  * has been running for more than `ms` milliseconds.
  *
@@ -2004,7 +2003,7 @@ Query.prototype._optionsForExec = function(model) {
  * Sets the lean option.
  *
  * Documents returned from queries with the `lean` option enabled are plain
- * javascript objects, not [Mongoose Documents](/api/document.html). They have no
+ * javascript objects, not [Mongoose Documents](/docs/api/document.html). They have no
  * `save` method, getters/setters, virtuals, or other Mongoose features.
  *
  * #### Example:
@@ -2166,11 +2165,11 @@ Query.prototype._unsetCastError = function _unsetCastError() {
  * Getter/setter around the current mongoose-specific options for this query
  * Below are the current Mongoose-specific options.
  *
- * - `populate`: an array representing what paths will be populated. Should have one entry for each call to [`Query.prototype.populate()`](/docs/api/query.html#query_Query-populate)
- * - `lean`: if truthy, Mongoose will not [hydrate](/docs/api/model.html#model_Model-hydrate) any documents that are returned from this query. See [`Query.prototype.lean()`](/docs/api/query.html#query_Query-lean) for more information.
+ * - `populate`: an array representing what paths will be populated. Should have one entry for each call to [`Query.prototype.populate()`](#query_Query-populate)
+ * - `lean`: if truthy, Mongoose will not [hydrate](/docs/api/model.html#model_Model-hydrate) any documents that are returned from this query. See [`Query.prototype.lean()`](#query_Query-lean) for more information.
  * - `strict`: controls how Mongoose handles keys that aren't in the schema for updates. This option is `true` by default, which means Mongoose will silently strip any paths in the update that aren't in the schema. See the [`strict` mode docs](/docs/guide.html#strict) for more information.
  * - `strictQuery`: controls how Mongoose handles keys that aren't in the schema for the query `filter`. This option is `false` by default for backwards compatibility, which means Mongoose will allow `Model.find({ foo: 'bar' })` even if `foo` is not in the schema. See the [`strictQuery` docs](/docs/guide.html#strictQuery) for more information.
- * - `nearSphere`: use `$nearSphere` instead of `near()`. See the [`Query.prototype.nearSphere()` docs](/docs/api/query.html#query_Query-nearSphere)
+ * - `nearSphere`: use `$nearSphere` instead of `near()`. See the [`Query.prototype.nearSphere()` docs](#query_Query-nearSphere)
  *
  * Mongoose maintains a separate object for internal options because
  * Mongoose sends `Query.prototype.options` to the MongoDB server, and the
@@ -2330,7 +2329,7 @@ Query.prototype._find = wrapThunk(function(callback) {
  * Find all documents that match `selector`. The result will be an array of documents.
  *
  * If there are too many documents in the result to fit in memory, use
- * [`Query.prototype.cursor()`](api/query.html#query_Query-cursor)
+ * [`Query.prototype.cursor()`](#query_Query-cursor)
  *
  * #### Example:
  *
@@ -2436,7 +2435,7 @@ Query.prototype.merge = function(source) {
  *
  * @param {Object} value
  * @return {Query} this
- * @see MongoDB docs https://docs.mongodb.com/manual/reference/method/cursor.collation/#cursor.collation
+ * @see MongoDB docs https://www.mongodb.com/docs/manual/reference/method/cursor.collation/#cursor.collation
  * @api public
  */
 
@@ -2509,7 +2508,7 @@ Query.prototype._completeOne = function(doc, res, callback) {
  * Thunk around findOne()
  *
  * @param {Function} [callback]
- * @see findOne https://docs.mongodb.org/manual/reference/method/db.collection.findOne/
+ * @see findOne https://www.mongodb.com/docs/manual/reference/method/db.collection.findOne/
  * @api private
  */
 
@@ -2563,10 +2562,10 @@ Query.prototype._findOne = wrapThunk(function(callback) {
  *
  * @param {Object} [filter] mongodb selector
  * @param {Object} [projection] optional fields to return
- * @param {Object} [options] see [`setOptions()`](https://mongoosejs.com/docs/api/query.html#query_Query-setOptions)
+ * @param {Object} [options] see [`setOptions()`](#query_Query-setOptions)
  * @param {Function} [callback] optional params are (error, document)
  * @return {Query} this
- * @see findOne https://docs.mongodb.org/manual/reference/method/db.collection.findOne/
+ * @see findOne https://www.mongodb.com/docs/manual/reference/method/db.collection.findOne/
  * @see Query.select #query_Query-select
  * @api public
  */
@@ -2621,7 +2620,7 @@ Query.prototype.findOne = function(conditions, projection, options, callback) {
  * Thunk around count()
  *
  * @param {Function} [callback]
- * @see count https://docs.mongodb.org/manual/reference/method/db.collection.count/
+ * @see count https://www.mongodb.com/docs/manual/reference/method/db.collection.count/
  * @api private
  */
 
@@ -2695,8 +2694,8 @@ Query.prototype._estimatedDocumentCount = wrapThunk(function(callback) {
  * Specifies this query as a `count` query.
  *
  * This method is deprecated. If you want to count the number of documents in
- * a collection, e.g. `count({})`, use the [`estimatedDocumentCount()` function](/docs/api/query.html#query_Query-estimatedDocumentCount)
- * instead. Otherwise, use the [`countDocuments()`](/docs/api/query.html#query_Query-countDocuments) function instead.
+ * a collection, e.g. `count({})`, use the [`estimatedDocumentCount()` function](#query_Query-estimatedDocumentCount)
+ * instead. Otherwise, use the [`countDocuments()`](#query_Query-countDocuments) function instead.
  *
  * Passing a `callback` executes the query.
  *
@@ -2721,7 +2720,7 @@ Query.prototype._estimatedDocumentCount = wrapThunk(function(callback) {
  * @param {Object} [filter] count documents that match this object
  * @param {Function} [callback] optional params are (error, count)
  * @return {Query} this
- * @see count https://docs.mongodb.org/manual/reference/method/db.collection.count/
+ * @see count https://www.mongodb.com/docs/manual/reference/method/db.collection.count/
  * @api public
  */
 
@@ -2825,9 +2824,9 @@ Query.prototype.estimatedDocumentCount = function(options, callback) {
  * Below are the operators that `count()` supports but `countDocuments()` does not,
  * and the suggested replacement:
  *
- * - `$where`: [`$expr`](https://docs.mongodb.com/manual/reference/operator/query/expr/)
- * - `$near`: [`$geoWithin`](https://docs.mongodb.com/manual/reference/operator/query/geoWithin/) with [`$center`](https://docs.mongodb.com/manual/reference/operator/query/center/#op._S_center)
- * - `$nearSphere`: [`$geoWithin`](https://docs.mongodb.com/manual/reference/operator/query/geoWithin/) with [`$centerSphere`](https://docs.mongodb.com/manual/reference/operator/query/centerSphere/#op._S_centerSphere)
+ * - `$where`: [`$expr`](https://www.mongodb.com/docs/manual/reference/operator/query/expr/)
+ * - `$near`: [`$geoWithin`](https://www.mongodb.com/docs/manual/reference/operator/query/geoWithin/) with [`$center`](https://www.mongodb.com/docs/manual/reference/operator/query/center/#op._S_center)
+ * - `$nearSphere`: [`$geoWithin`](https://www.mongodb.com/docs/manual/reference/operator/query/geoWithin/) with [`$centerSphere`](https://www.mongodb.com/docs/manual/reference/operator/query/centerSphere/#op._S_centerSphere)
  *
  * @param {Object} [filter] mongodb selector
  * @param {Object} [options]
@@ -2873,7 +2872,7 @@ Query.prototype.countDocuments = function(conditions, options, callback) {
  * Thunk around distinct()
  *
  * @param {Function} [callback]
- * @see distinct https://docs.mongodb.org/manual/reference/method/db.collection.distinct/
+ * @see distinct https://www.mongodb.com/docs/manual/reference/method/db.collection.distinct/
  * @api private
  */
 
@@ -2915,7 +2914,7 @@ Query.prototype.__distinct = wrapThunk(function __distinct(callback) {
  * @param {Object|Query} [filter]
  * @param {Function} [callback] optional params are (error, arr)
  * @return {Query} this
- * @see distinct https://docs.mongodb.org/manual/reference/method/db.collection.distinct/
+ * @see distinct https://www.mongodb.com/docs/manual/reference/method/db.collection.distinct/
  * @api public
  */
 
@@ -2980,7 +2979,7 @@ Query.prototype.distinct = function(field, conditions, callback) {
  *
  * @param {Object|String|Array<Array<(string | number)>>} arg
  * @return {Query} this
- * @see cursor.sort https://docs.mongodb.org/manual/reference/method/cursor.sort/
+ * @see cursor.sort https://www.mongodb.com/docs/manual/reference/method/cursor.sort/
  * @api public
  */
 
@@ -3019,7 +3018,7 @@ Query.prototype.sort = function(arg) {
  *
  * #### Note:
  *
- * Calling `remove()` creates a [Mongoose query](./queries.html), and a query
+ * Calling `remove()` creates a [Mongoose query](/docs/queries.html), and a query
  * does not execute until you either pass a callback, call [`Query#then()`](#query_Query-then),
  * or call [`Query#exec()`](#query_Query-exec).
  *
@@ -3118,7 +3117,7 @@ Query.prototype._remove = wrapThunk(function(callback) {
  *     res.deletedCount;
  *
  * @param {Object|Query} [filter] mongodb selector
- * @param {Object} [options] optional see [`Query.prototype.setOptions()`](https://mongoosejs.com/docs/api/query.html#query_Query-setOptions)
+ * @param {Object} [options] optional see [`Query.prototype.setOptions()`](#query_Query-setOptions)
  * @param {Function} [callback] optional params are (error, mongooseDeleteResult)
  * @return {Query} this
  * @see DeleteResult https://mongodb.github.io/node-mongodb-native/4.9/interfaces/DeleteResult.html
@@ -3209,7 +3208,7 @@ Query.prototype._deleteOne = wrapThunk(function(callback) {
  *     res.deletedCount;
  *
  * @param {Object|Query} [filter] mongodb selector
- * @param {Object} [options] optional see [`Query.prototype.setOptions()`](https://mongoosejs.com/docs/api/query.html#query_Query-setOptions)
+ * @param {Object} [options] optional see [`Query.prototype.setOptions()`](#query_Query-setOptions)
  * @param {Function} [callback] optional params are (error, mongooseDeleteResult)
  * @return {Query} this
  * @see DeleteResult https://mongodb.github.io/node-mongodb-native/4.9/interfaces/DeleteResult.html
@@ -3335,7 +3334,7 @@ function prepareDiscriminatorCriteria(query) {
 }
 
 /**
- * Issues a mongodb [findAndModify](https://www.mongodb.org/display/DOCS/findAndModify+Command) update command.
+ * Issues a mongodb [findAndModify](https://www.mongodb.com/docs/manual/reference/command/findAndModify/) update command.
  *
  * Finds a matching document, updates it according to the `update` arg, passing any `options`, and returns the found
  * document (if any) to the callback. The query executes if
@@ -3385,7 +3384,7 @@ function prepareDiscriminatorCriteria(query) {
  * @param {ClientSession} [options.session=null] The session associated with this query. See [transactions docs](/docs/transactions.html).
  * @param {Boolean} [options.multipleCastError] by default, mongoose only returns the first error that occurred in casting the query. Turn on this option to aggregate all the cast errors.
  * @param {Boolean} [options.new=false] By default, `findOneAndUpdate()` returns the document as it was **before** `update` was applied. If you set `new: true`, `findOneAndUpdate()` will instead give you the object after `update` was applied.
- * @param {Object} [options.lean] if truthy, mongoose will return the document as a plain JavaScript object rather than a mongoose document. See [`Query.lean()`](/docs/api/query.html#query_Query-lean) and [the Mongoose lean tutorial](/docs/tutorials/lean.html).
+ * @param {Object} [options.lean] if truthy, mongoose will return the document as a plain JavaScript object rather than a mongoose document. See [`Query.lean()`](#query_Query-lean) and [the Mongoose lean tutorial](/docs/tutorials/lean.html).
  * @param {ClientSession} [options.session=null] The session associated with this query. See [transactions docs](/docs/transactions.html).
  * @param {Boolean|String} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Note that this allows you to overwrite timestamps. Does nothing if schema-level timestamps are not set.
@@ -3487,7 +3486,7 @@ Query.prototype._findOneAndUpdate = wrapThunk(function(callback) {
 });
 
 /**
- * Issues a mongodb [findAndModify](https://www.mongodb.org/display/DOCS/findAndModify+Command) remove command.
+ * Issues a mongodb [findAndModify](https://www.mongodb.com/docs/manual/reference/command/findAndModify/) remove command.
  *
  * Finds a matching document, removes it, passing the found document (if any) to
  * the callback. Executes if `callback` is passed.
@@ -3569,7 +3568,7 @@ Query.prototype.findOneAndRemove = function(conditions, options, callback) {
 };
 
 /**
- * Issues a MongoDB [findOneAndDelete](https://docs.mongodb.com/manual/reference/method/db.collection.findOneAndDelete/) command.
+ * Issues a MongoDB [findOneAndDelete](https://www.mongodb.com/docs/manual/reference/method/db.collection.findOneAndDelete/) command.
  *
  * Finds a matching document, removes it, and passes the found document (if any)
  * to the callback. Executes if `callback` is passed.
@@ -3579,7 +3578,7 @@ Query.prototype.findOneAndRemove = function(conditions, options, callback) {
  * - `findOneAndDelete()`
  *
  * This function differs slightly from `Model.findOneAndRemove()` in that
- * `findOneAndRemove()` becomes a [MongoDB `findAndModify()` command](https://docs.mongodb.com/manual/reference/method/db.collection.findAndModify/),
+ * `findOneAndRemove()` becomes a [MongoDB `findAndModify()` command](https://www.mongodb.com/docs/manual/reference/method/db.collection.findAndModify/),
  * as opposed to a `findOneAndDelete()` command. For most mongoose use cases,
  * this distinction is purely pedantic. You should use `findOneAndDelete()`
  * unless you have a good reason not to.
@@ -3697,7 +3696,7 @@ Query.prototype._findOneAndDelete = wrapThunk(function(callback) {
 });
 
 /**
- * Issues a MongoDB [findOneAndReplace](https://docs.mongodb.com/manual/reference/method/db.collection.findOneAndReplace/) command.
+ * Issues a MongoDB [findOneAndReplace](https://www.mongodb.com/docs/manual/reference/method/db.collection.findOneAndReplace/) command.
  *
  * Finds a matching document, removes it, and passes the found document (if any)
  * to the callback. Executes if `callback` is passed.
@@ -3737,7 +3736,7 @@ Query.prototype._findOneAndDelete = wrapThunk(function(callback) {
  * @param {ClientSession} [options.session=null] The session associated with this query. See [transactions docs](/docs/transactions.html).
  * @param {Boolean|String} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @param {Boolean} [options.new=false] By default, `findOneAndUpdate()` returns the document as it was **before** `update` was applied. If you set `new: true`, `findOneAndUpdate()` will instead give you the object after `update` was applied.
- * @param {Object} [options.lean] if truthy, mongoose will return the document as a plain JavaScript object rather than a mongoose document. See [`Query.lean()`](/docs/api/query.html#query_Query-lean) and [the Mongoose lean tutorial](/docs/tutorials/lean.html).
+ * @param {Object} [options.lean] if truthy, mongoose will return the document as a plain JavaScript object rather than a mongoose document. See [`Query.lean()`](#query_Query-lean) and [the Mongoose lean tutorial](/docs/tutorials/lean.html).
  * @param {ClientSession} [options.session=null] The session associated with this query. See [transactions docs](/docs/transactions.html).
  * @param {Boolean|String} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Note that this allows you to overwrite timestamps. Does nothing if schema-level timestamps are not set.
@@ -4396,7 +4395,7 @@ Query.prototype._replaceOne = wrapThunk(function(callback) {
 /**
  * Declare and/or execute this query as an update() operation.
  *
- * _All paths passed that are not [atomic](https://docs.mongodb.com/manual/tutorial/model-data-for-atomic-operations/#pattern) operations will become `$set` ops._
+ * _All paths passed that are not [atomic](https://www.mongodb.com/docs/manual/tutorial/model-data-for-atomic-operations/#pattern) operations will become `$set` ops._
  *
  * This function triggers the following middleware.
  *
@@ -4434,7 +4433,7 @@ Query.prototype._replaceOne = wrapThunk(function(callback) {
  *
  * q.update({ $set: { name: 'bob' }}).exec(); // executed
  *
- * // keys that are not [atomic](https://docs.mongodb.com/manual/tutorial/model-data-for-atomic-operations/#pattern) ops become `$set`.
+ * // keys that are not [atomic](https://www.mongodb.com/docs/manual/tutorial/model-data-for-atomic-operations/#pattern) ops become `$set`.
  * // this executes the same command as the previous example.
  * q.update({ name: 'bob' }).exec();
  *
@@ -4472,15 +4471,15 @@ Query.prototype._replaceOne = wrapThunk(function(callback) {
  * @param {Boolean} [options.multipleCastError] by default, mongoose only returns the first error that occurred in casting the query. Turn on this option to aggregate all the cast errors.
  * @param {Boolean|String} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @param {Boolean} [options.upsert=false] if true, and no documents found, insert a new document
- * @param {Object} [options.writeConcern=null] sets the [write concern](https://docs.mongodb.com/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
+ * @param {Object} [options.writeConcern=null] sets the [write concern](https://www.mongodb.com/docs/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
  * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Does nothing if schema-level timestamps are not set.
  * @param {Function} [callback] params are (error, writeOpResult)
  * @return {Query} this
  * @see Model.update #model_Model-update
  * @see Query docs https://mongoosejs.com/docs/queries.html
- * @see update https://docs.mongodb.org/manual/reference/method/db.collection.update/
+ * @see update https://www.mongodb.com/docs/manual/reference/method/db.collection.update/
  * @see UpdateResult https://mongodb.github.io/node-mongodb-native/4.9/interfaces/UpdateResult.html
- * @see MongoDB docs https://docs.mongodb.com/manual/reference/command/update/#update-command-output
+ * @see MongoDB docs https://www.mongodb.com/docs/manual/reference/command/update/#update-command-output
  * @api public
  */
 
@@ -4537,15 +4536,15 @@ Query.prototype.update = function(conditions, doc, options, callback) {
  * @param {Boolean} [options.multipleCastError] by default, mongoose only returns the first error that occurred in casting the query. Turn on this option to aggregate all the cast errors.
  * @param {Boolean|String} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @param {Boolean} [options.upsert=false] if true, and no documents found, insert a new document
- * @param {Object} [options.writeConcern=null] sets the [write concern](https://docs.mongodb.com/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
+ * @param {Object} [options.writeConcern=null] sets the [write concern](https://www.mongodb.com/docs/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
  * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Does nothing if schema-level timestamps are not set.
  * @param {Function} [callback] params are (error, writeOpResult)
  * @return {Query} this
  * @see Model.update #model_Model-update
  * @see Query docs https://mongoosejs.com/docs/queries.html
- * @see update https://docs.mongodb.org/manual/reference/method/db.collection.update/
+ * @see update https://www.mongodb.com/docs/manual/reference/method/db.collection.update/
  * @see UpdateResult https://mongodb.github.io/node-mongodb-native/4.9/interfaces/UpdateResult.html
- * @see MongoDB docs https://docs.mongodb.com/manual/reference/command/update/#update-command-output
+ * @see MongoDB docs https://www.mongodb.com/docs/manual/reference/command/update/#update-command-output
  * @api public
  */
 
@@ -4582,7 +4581,7 @@ Query.prototype.updateMany = function(conditions, doc, options, callback) {
  * `update()`, except it does not support the `multi` option.
  *
  * - MongoDB will update _only_ the first document that matches `filter` regardless of the value of the `multi` option.
- * - Use `replaceOne()` if you want to overwrite an entire document rather than using [atomic](https://docs.mongodb.com/manual/tutorial/model-data-for-atomic-operations/#pattern) operators like `$set`.
+ * - Use `replaceOne()` if you want to overwrite an entire document rather than using [atomic](https://www.mongodb.com/docs/manual/tutorial/model-data-for-atomic-operations/#pattern) operators like `$set`.
  *
  * **Note** updateOne will _not_ fire update middleware. Use `pre('updateOne')`
  * and `post('updateOne')` instead.
@@ -4606,15 +4605,15 @@ Query.prototype.updateMany = function(conditions, doc, options, callback) {
  * @param {Boolean} [options.multipleCastError] by default, mongoose only returns the first error that occurred in casting the query. Turn on this option to aggregate all the cast errors.
  * @param {Boolean|String} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @param {Boolean} [options.upsert=false] if true, and no documents found, insert a new document
- * @param {Object} [options.writeConcern=null] sets the [write concern](https://docs.mongodb.com/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
+ * @param {Object} [options.writeConcern=null] sets the [write concern](https://www.mongodb.com/docs/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
  * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Note that this allows you to overwrite timestamps. Does nothing if schema-level timestamps are not set.
  * @param {Function} [callback] params are (error, writeOpResult)
  * @return {Query} this
  * @see Model.update #model_Model-update
  * @see Query docs https://mongoosejs.com/docs/queries.html
- * @see update https://docs.mongodb.org/manual/reference/method/db.collection.update/
+ * @see update https://www.mongodb.com/docs/manual/reference/method/db.collection.update/
  * @see UpdateResult https://mongodb.github.io/node-mongodb-native/4.9/interfaces/UpdateResult.html
- * @see MongoDB docs https://docs.mongodb.com/manual/reference/command/update/#update-command-output
+ * @see MongoDB docs https://www.mongodb.com/docs/manual/reference/command/update/#update-command-output
  * @api public
  */
 
@@ -4649,7 +4648,7 @@ Query.prototype.updateOne = function(conditions, doc, options, callback) {
 /**
  * Declare and/or execute this query as a replaceOne() operation. Same as
  * `update()`, except MongoDB will replace the existing document and will
- * not accept any [atomic](https://docs.mongodb.com/manual/tutorial/model-data-for-atomic-operations/#pattern) operators (`$set`, etc.)
+ * not accept any [atomic](https://www.mongodb.com/docs/manual/tutorial/model-data-for-atomic-operations/#pattern) operators (`$set`, etc.)
  *
  * **Note** replaceOne will _not_ fire update middleware. Use `pre('replaceOne')`
  * and `post('replaceOne')` instead.
@@ -4673,15 +4672,15 @@ Query.prototype.updateOne = function(conditions, doc, options, callback) {
  * @param {Boolean} [options.multipleCastError] by default, mongoose only returns the first error that occurred in casting the query. Turn on this option to aggregate all the cast errors.
  * @param {Boolean|String} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @param {Boolean} [options.upsert=false] if true, and no documents found, insert a new document
- * @param {Object} [options.writeConcern=null] sets the [write concern](https://docs.mongodb.com/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
+ * @param {Object} [options.writeConcern=null] sets the [write concern](https://www.mongodb.com/docs/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
  * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Does nothing if schema-level timestamps are not set.
  * @param {Function} [callback] params are (error, writeOpResult)
  * @return {Query} this
  * @see Model.update #model_Model-update
  * @see Query docs https://mongoosejs.com/docs/queries.html
- * @see update https://docs.mongodb.org/manual/reference/method/db.collection.update/
+ * @see update https://www.mongodb.com/docs/manual/reference/method/db.collection.update/
  * @see UpdateResult https://mongodb.github.io/node-mongodb-native/4.9/interfaces/UpdateResult.html
- * @see MongoDB docs https://docs.mongodb.com/manual/reference/command/update/#update-command-output
+ * @see MongoDB docs https://www.mongodb.com/docs/manual/reference/command/update/#update-command-output
  * @api public
  */
 
@@ -5100,7 +5099,9 @@ Query.prototype._castUpdate = function _castUpdate(obj, overwrite) {
   if (this._mongooseOptions.overwriteDiscriminatorKey &&
       obj[discriminatorKey] != null &&
       baseSchema.discriminators) {
-    const _schema = baseSchema.discriminators[obj[discriminatorKey]];
+    const _schema = Object.values(baseSchema.discriminators).find(
+      discriminator => discriminator.discriminatorMapping.value === obj[discriminatorKey]
+    );
     if (_schema != null) {
       schema = _schema;
     }
@@ -5187,10 +5188,10 @@ function castQuery(query) {
  * @param {boolean} [options.retainNullValues=false] by default, Mongoose removes null and undefined values from populated arrays. Use this option to make `populate()` retain `null` and `undefined` array entries.
  * @param {boolean} [options.getters=false] if true, Mongoose will call any getters defined on the `localField`. By default, Mongoose gets the raw value of `localField`. For example, you would need to set this option to `true` if you wanted to [add a `lowercase` getter to your `localField`](/docs/schematypes.html#schematype-options).
  * @param {boolean} [options.clone=false] When you do `BlogPost.find().populate('author')`, blog posts with the same author will share 1 copy of an `author` doc. Enable this option to make Mongoose clone populated docs before assigning them.
- * @param {Object|Function} [options.match=null] Add an additional filter to the populate query. Can be a filter object containing [MongoDB query syntax](https://docs.mongodb.com/manual/tutorial/query-documents/), or a function that returns a filter object.
+ * @param {Object|Function} [options.match=null] Add an additional filter to the populate query. Can be a filter object containing [MongoDB query syntax](https://www.mongodb.com/docs/manual/tutorial/query-documents/), or a function that returns a filter object.
  * @param {Function} [options.transform=null] Function that Mongoose will call on every populated document that allows you to transform the populated document.
  * @param {Object} [options.options=null] Additional options like `limit` and `lean`.
- * @see population /docs/populate
+ * @see population /docs/populate.html
  * @see Query#select #query_Query-select
  * @see Model.populate #model_Model-populate
  * @return {Query} this
@@ -5355,7 +5356,7 @@ Query.prototype.cast = function(model, obj) {
  *
  * @param {Object} fields
  * @see https://github.com/Automattic/mongoose/issues/1091
- * @see https://docs.mongodb.org/manual/reference/projection/elemMatch/
+ * @see https://www.mongodb.com/docs/manual/reference/projection/elemMatch/
  * @api private
  */
 
@@ -5461,7 +5462,7 @@ Query.prototype._applyPaths = function applyPaths() {
  *
  * @return {QueryCursor}
  * @param {Object} [options]
- * @see QueryCursor /docs/api/querycursor
+ * @see QueryCursor /docs/api/querycursor.html
  * @api public
  */
 
@@ -5519,7 +5520,7 @@ Query.prototype.maxscan = Query.base.maxScan;
  * @param {Object} [opts] options to set
  * @param {Boolean} [opts.awaitData] false by default. Set to true to keep the cursor open even if there's no data.
  * @param {Number} [opts.maxAwaitTimeMS] the maximum amount of time for the server to wait on new documents to satisfy a tailable cursor query. Requires `tailable` and `awaitData` to be true
- * @see tailable https://docs.mongodb.org/manual/tutorial/create-tailable-cursor/
+ * @see tailable https://www.mongodb.com/docs/manual/tutorial/create-tailable-cursor/
  * @api public
  */
 
@@ -5577,8 +5578,8 @@ Query.prototype.tailable = function(val, opts) {
  * @instance
  * @param {Object} [arg]
  * @return {Query} this
- * @see $geometry https://docs.mongodb.org/manual/reference/operator/geometry/
- * @see geoIntersects https://docs.mongodb.org/manual/reference/operator/geoIntersects/
+ * @see $geometry https://www.mongodb.com/docs/manual/reference/operator/geometry/
+ * @see geoIntersects https://www.mongodb.com/docs/manual/reference/operator/geoIntersects/
  * @api public
  */
 
@@ -5616,9 +5617,9 @@ Query.prototype.tailable = function(val, opts) {
  * @instance
  * @param {Object} object Must contain a `type` property which is a String and a `coordinates` property which is an Array. See the examples.
  * @return {Query} this
- * @see $geometry https://docs.mongodb.org/manual/reference/operator/geometry/
+ * @see $geometry https://www.mongodb.com/docs/manual/reference/operator/geometry/
  * @see Geospatial Support Enhancements https://www.mongodb.com/docs/manual/release-notes/2.4/#geospatial-support-enhancements
- * @see MongoDB Geospatial Indexing https://www.mongodb.org/display/DOCS/Geospatial+Indexing
+ * @see MongoDB Geospatial Indexing https://www.mongodb.com/docs/manual/core/geospatial-indexes/
  * @api public
  */
 
@@ -5640,10 +5641,10 @@ Query.prototype.tailable = function(val, opts) {
  * @param {String} [path]
  * @param {Object} val
  * @return {Query} this
- * @see $near https://docs.mongodb.org/manual/reference/operator/near/
- * @see $nearSphere https://docs.mongodb.org/manual/reference/operator/nearSphere/
- * @see $maxDistance https://docs.mongodb.org/manual/reference/operator/maxDistance/
- * @see MongoDB Geospatial Indexing https://www.mongodb.org/display/DOCS/Geospatial+Indexing
+ * @see $near https://www.mongodb.com/docs/manual/reference/operator/near/
+ * @see $nearSphere https://www.mongodb.com/docs/manual/reference/operator/nearSphere/
+ * @see $maxDistance https://www.mongodb.com/docs/manual/reference/operator/maxDistance/
+ * @see MongoDB Geospatial Indexing https://www.mongodb.com/docs/manual/core/geospatial-indexes/
  * @api public
  */
 
@@ -5727,9 +5728,9 @@ Query.prototype.near = function() {
  *
  * @deprecated
  * @see near() #query_Query-near
- * @see $near https://docs.mongodb.org/manual/reference/operator/near/
- * @see $nearSphere https://docs.mongodb.org/manual/reference/operator/nearSphere/
- * @see $maxDistance https://docs.mongodb.org/manual/reference/operator/maxDistance/
+ * @see $near https://www.mongodb.com/docs/manual/reference/operator/near/
+ * @see $nearSphere https://www.mongodb.com/docs/manual/reference/operator/nearSphere/
+ * @see $maxDistance https://www.mongodb.com/docs/manual/reference/operator/maxDistance/
  */
 
 Query.prototype.nearSphere = function() {
@@ -5783,8 +5784,8 @@ if (Symbol.asyncIterator != null) {
  * @param {String|Array} [path]
  * @param {Array|Object} [coordinatePairs...]
  * @return {Query} this
- * @see $polygon https://docs.mongodb.org/manual/reference/operator/polygon/
- * @see MongoDB Geospatial Indexing https://www.mongodb.org/display/DOCS/Geospatial+Indexing
+ * @see $polygon https://www.mongodb.com/docs/manual/reference/operator/polygon/
+ * @see MongoDB Geospatial Indexing https://www.mongodb.com/docs/manual/core/geospatial-indexes/
  * @api public
  */
 
@@ -5802,9 +5803,9 @@ if (Symbol.asyncIterator != null) {
  * @method box
  * @memberOf Query
  * @instance
- * @see $box https://docs.mongodb.org/manual/reference/operator/box/
+ * @see $box https://www.mongodb.com/docs/manual/reference/operator/box/
  * @see within() Query#within #query_Query-within
- * @see MongoDB Geospatial Indexing https://www.mongodb.org/display/DOCS/Geospatial+Indexing
+ * @see MongoDB Geospatial Indexing https://www.mongodb.com/docs/manual/core/geospatial-indexes/
  * @param {Object|Array<Number>} val1 Lower Left Coordinates OR a object of lower-left(ll) and upper-right(ur) Coordinates
  * @param {Array<Number>} [val2] Upper Right Coordinates
  * @return {Query} this
@@ -5852,10 +5853,10 @@ Query.prototype.box = function(ll, ur) {
  * @param {String} [path]
  * @param {Object} area
  * @return {Query} this
- * @see $center https://docs.mongodb.org/manual/reference/operator/center/
- * @see $centerSphere https://docs.mongodb.org/manual/reference/operator/centerSphere/
- * @see $geoWithin https://docs.mongodb.org/manual/reference/operator/geoWithin/
- * @see MongoDB Geospatial Indexing https://www.mongodb.org/display/DOCS/Geospatial+Indexing
+ * @see $center https://www.mongodb.com/docs/manual/reference/operator/center/
+ * @see $centerSphere https://www.mongodb.com/docs/manual/reference/operator/centerSphere/
+ * @see $geoWithin https://www.mongodb.com/docs/manual/reference/operator/geoWithin/
+ * @see MongoDB Geospatial Indexing https://www.mongodb.com/docs/manual/core/geospatial-indexes/
  * @api public
  */
 
@@ -5887,8 +5888,8 @@ Query.prototype.center = Query.base.circle;
  * @param {String} [path]
  * @param {Object} val
  * @return {Query} this
- * @see MongoDB Geospatial Indexing https://www.mongodb.org/display/DOCS/Geospatial+Indexing
- * @see $centerSphere https://docs.mongodb.org/manual/reference/operator/centerSphere/
+ * @see MongoDB Geospatial Indexing https://www.mongodb.com/docs/manual/core/geospatial-indexes/
+ * @see $centerSphere https://www.mongodb.com/docs/manual/reference/operator/centerSphere/
  * @api public
  */