diff --git a/core/modules/migrate/migrate.api.php b/core/modules/migrate/migrate.api.php
index df5c66d..48cbf24 100644
--- a/core/modules/migrate/migrate.api.php
+++ b/core/modules/migrate/migrate.api.php
@@ -38,7 +38,7 @@
  *
  * The configuration of migrations is stored in configuration entities, which
  * list the IDs and configurations of the plugins that are involved. See
- * @ref sec_entity below for details. To migrate an entire site, you'll need to
+ * @ref sec_migrations below for details. To migrate an entire site, you'll need to
  * create a migration manifest; see @ref sec_manifest for details.
  *
  * https://www.drupal.org/node/2127611 has more complete information on the
@@ -73,17 +73,17 @@
  * are managed by the
  * \Drupal\migrate\Plugin\MigrateDestinationPluginManager class.
  *
- * @section sec_entity Migration configuration entities
- * The definition of how to migrate each type of data is stored in configuration
- * entities. The migration configuration entity class is
- * \Drupal\migrate\Entity\Migration, with interface
- * \Drupal\migrate\Entity\MigrationInterface; the configuration schema can be
- * found in the migrate.schema.yml file. Migration configuration consists of IDs
+ * @section sec_migrations Migration plugins
+ * The definition of how to migrate each type of data is stored in a plugin. The
+ * plugin class is \Drupal\migrate\Plugin\Migration, with interface
+ * \Drupal\migrate\MigrationInterface. Migration plugins of IDs
  * and configuration for the source, process, and destination plugins, as well
  * as information on dependencies. Process configuration consists of sections,
  * each of which defines the series of process plugins needed for one
- * destination property. You can find examples of migration configuration files
- * in the core/modules/migrate_drupal/config/install directory.
+ * destination property. Migration plugin definitions are stored in a module's
+ * 'migrations' directory. For backwards compatibility we also scan the
+ * 'migration_templates' directory too. An examples migration plugin
+ * definitions can be found in 'core/modules/action/migration_templates'.
  *
  * @section sec_manifest Migration manifests
  * You can run a migration with the "drush migrate-manifest" command, providing