diff --git a/lib/collection.js b/lib/collection.js
index <HASH>..<HASH> 100644
--- a/lib/collection.js
+++ b/lib/collection.js
@@ -1453,7 +1453,7 @@ Collection.prototype.stats = function(options, callback) {
 
 /**
  * @typedef {Object} Collection~findAndModifyWriteOpResult
- * @property {object} value Document returned from findAndModify command.
+ * @property {object} value Document returned from the `findAndModify` command. If no documents were found, `value` will be `null` by default (`returnOriginal: true`), even if a document was upserted; if `returnOriginal` was false, the upserted document will be returned in that case.
  * @property {object} lastErrorObject The raw lastErrorObject returned from the command.
  * @property {Number} ok Is 1 if the command executed correctly.
  */
docs(Collection): clarify findAndModify's result.value

* Clarify that findAndModify's result.value doesn't echo upserted docs

* Clarify the value returned when upserting a document