Issue #2949376 by aaronbauman: Update some documentation and add pull examples to sf subscriber

modules/salesforce_mapping/src/Entity/MappedObject.php

@@ -154,7 +154,7 @@ class MappedObject extends RevisionableContentEntityBase implements MappedObject
       return;
     }
     foreach ($vids_to_delete as $vid => $dummy) {
-      $storage->deleteRevision($vid);      
+      $storage->deleteRevision($vid);
     }
     return $this;
   }
@@ -497,9 +497,7 @@ class MappedObject extends RevisionableContentEntityBase implements MappedObject
   }
 
   /**
-   * Get the mapped Salesforce record.
-   *
-   * @return \Drupal\salesforce\SObject
+   * {@inheritdoc}
    */
   public function getSalesforceRecord() {
     return $this->sf_object;

modules/salesforce_mapping/src/Entity/MappedObjectInterface.php

@@ -52,6 +52,13 @@ interface MappedObjectInterface extends EntityChangedInterface, RevisionLogInter
   public function getSalesforceUrl();
 
   /**
+   * Get the mapped Salesforce record.
+   *
+   * @return \Drupal\salesforce\SObject
+   */
+  public function getSalesforceRecord();
+
+    /**
    * @return string
    *   SFID
    */

modules/salesforce_mapping/src/Entity/SalesforceMapping.php

@@ -601,6 +601,7 @@ class SalesforceMapping extends ConfigEntityBase implements SalesforceMappingInt
     if (!empty($this->pull_where_clause)) {
       $soql->conditions[] = [$this->pull_where_clause];
     }
+    $soql->order[$this->getPullTriggerDate()] = 'ASC';
     return $soql;
   }
 

modules/salesforce_mapping/src/Event/SalesforceQueryEvent.php

@@ -26,7 +26,7 @@ class SalesforceQueryEvent extends SalesforceBaseEvent {
   }
 
   /**
-   * @return EntityInterface (from PushParams)
+   * @return SelectQuery
    */
   public function getQuery() {
     return $this->query;