user doc: Updated description of Find and Upsert actions
@@ -70,7 +70,11 @@ table as well.
|*Find*
|Looks for all documents that match the filter expression that you specify.
|In the *Filter expression* field, specify a JSON notation string that identifies one or more documents.
-|JSON notation that specifies a list (an array). Each list element conforms to a JSON schema and identifies a document that matches the filter expression.
+|JSON notation that specifies a list (an array). Each list element identifies a document that matches the
+filter expression and provides the document content. If no documents are found, the action returns an empty list. +
+You must be familiar with the data model of the collection. If the collection adheres to a JSON schema,
+you must be familiar with this schema because the returned list elements adhere to this schema. For additional information, see
+link:https://docs.mongodb.com/manual/data-modeling/[MongoDB Data Models].
|*Insert*
|Adds one or more documents to the collection.
@@ -87,12 +91,10 @@ format is described in link:https://docs.mongodb.com/manual/reference/method/db.
|*Upsert*
|Updates one or more documents in the collection or creates a document if no documents match the *Upsert expression*.
-|In the *Upsert expression* field, specify JSON notation that identifies the document(s)
-to update or the document to create.
-Also specify a MongoDB update statement that specifies how to
-update the document(s) or what the new document should contain.
-Update statement format is described in https://docs.mongodb.com/manual/reference/method/db.collection.update/.
-For example: ``[{"_id":11},{$set: {"test":"updated!"}}]`
+|In the *Upsert expression* field, specify JSON notation that identifies one or more documents. The action uses this expression
+to detect any matching documents. If the action finds a matching document(s) in the collection, it updates it. If the action does
+not find a matching document, the action creates a new document. The data coming in to the MongoDB connection must contain
+JSON notation that specifies the content to add or update.
|An instance of `com.mongodb.client.result.UpdateResult` that specifies either the number of updated documents or the ID of the new, inserted document.
|===
