diff --git a/packages/salesforce/src/Adaptor.js b/packages/salesforce/src/Adaptor.js
index 225a0a22b..f063d1b9e 100644
--- a/packages/salesforce/src/Adaptor.js
+++ b/packages/salesforce/src/Adaptor.js
@@ -26,17 +26,17 @@ import flatten from 'lodash/flatten';
  * State object
  * @typedef {Object} SalesforceState
  * @property data - API response data. Can be either an object or array of objects
- * @property references - History of all previous results
+ * @property references - History of all previous states
  **/
 
 /**
  * State object
  * @typedef {Object} SalesforceResultState
- * @property data - Contains a summary of the operation and any errors
+ * @property data - Summary of the response fom Salesforce
  * @property data.success - `true` if Salesforce reports no errors from the operation
  * @property data.completed - Array of ids for every successful completion
  * @property data.errors - Array of errors reported by Salesforce
- * @property references - History of all previous results
+ * @property references - History of all previous states
  **/
 
 /**