diff --git a/core/modules/migrate/migrate.api.php b/core/modules/migrate/migrate.api.php
index 5b1117f6d3..f3f60013dc 100644
--- a/core/modules/migrate/migrate.api.php
+++ b/core/modules/migrate/migrate.api.php
@@ -91,10 +91,10 @@
  *
  * @subsection sec_map_tables Map tables
  * Once a migrated row is saved and the destination IDs are known, Migrate API
- * saves the source IDs, destination IDs and the row hash into a map table. The
- * source IDs and the hash allow tracking changes for continuous migrations.
- * Other migrations can use the map tables for lookup purposes when establishing
- * relationships between records.
+ * saves the source IDs, destination IDs, and the row hash into a map table. The
+ * source IDs and the hash facilitate tracking changes for continuous
+ * migrations. Other migrations can use the map tables for lookup purposes when
+ * establishing relationships between records.
  *
  * @subsection sec_highwater_mark Highwater mark
  * A Highwater mark allows the Migrate API to track changes so that only data
@@ -116,13 +116,13 @@
  *
  * In this example, the row property 'changed' is the high_water_property. If
  * the value of 'changed' is greater than the current highwater mark the row
- * is processed and the value of the highwater mark is updated to the value
+ * is processed and the value of the highwater mark is updated to the value of
  * 'changed'.
  *
  * @subsection sec_rollbacks Rollbacks
  * When developing a migration, it is quite typical that the first version does
- * not provide correct results for all scenarios. Rollbacks allow you to undo a
- * migration and then execute it again after adjusting it.
+ * not provide correct results for all migrated data. Rollbacks allow you to
+ * undo a migration and then execute it again after adjusting it.
  *
  * @section sec_more_info Documentation handbooks
  * @link https://www.drupal.org/docs/8/api/migrate-api Migrate API handbook. @endlink