diff -u b/core/modules/migrate/src/Audit/AuditException.php b/core/modules/migrate/src/Audit/AuditException.php
--- b/core/modules/migrate/src/Audit/AuditException.php
+++ b/core/modules/migrate/src/Audit/AuditException.php
@@ -5,7 +5,7 @@
 use Drupal\migrate\Plugin\MigrationInterface;
 
 /**
- * Exception thrown when a migration audit fails.
+ * Defines an exception to throw if an error occurs during a migration audit.
  */
 class AuditException extends \RuntimeException {
 
diff -u b/core/modules/migrate/src/Plugin/Migration.php b/core/modules/migrate/src/Plugin/Migration.php
--- b/core/modules/migrate/src/Plugin/Migration.php
+++ b/core/modules/migrate/src/Plugin/Migration.php
@@ -18,10 +18,9 @@
  * process and destination plugins.
  *
  * Configuration options:
- *
- *   - audit: If set to TRUE, the migration's IDs will be audited. This means
- *     that if the highest destination ID is greater than the highest source ID,
- *     a warning will be displayed that entities might be overwritten.
+ * - audit: If set to TRUE, the migration's IDs will be audited. This means
+ *   that if the highest destination ID is greater than the highest source ID,
+ *   a warning will be displayed that entities might be overwritten.
  */
 class Migration extends PluginBase implements MigrationInterface, RequirementsInterface, ContainerFactoryPluginInterface {
 
diff -u b/core/modules/migrate/src/Plugin/migrate/id_map/Sql.php b/core/modules/migrate/src/Plugin/migrate/id_map/Sql.php
--- b/core/modules/migrate/src/Plugin/migrate/id_map/Sql.php
+++ b/core/modules/migrate/src/Plugin/migrate/id_map/Sql.php
@@ -930,7 +930,7 @@
   }
 
   /**
-   * Get the migration plugin manager.
+   * Returns the migration plugin manager.
    *
    * @todo Inject as a dependency in https://www.drupal.org/node/2919158.
    *