Move Migrate Run commands in Drush core

composer.json

@@ -63,6 +63,10 @@
     "squizlabs/php_codesniffer": "^2.7 || ^3",
     "vlucas/phpdotenv": "^2.4"
   },
+  "conflict": {
+    "drupal/migrate_run": "*",
+    "drupal/migrate_tools": "<= 5"
+  },
   "autoload": {
     "psr-4": {
       "Drush\\":            "src/",
@@ -73,6 +77,9 @@
     "psr-4": {
       "Unish\\": "tests/unish"
     },
+    "classmap": [
+        "sut/core/modules/migrate/src"
+    ],
     "files": ["tests/load.environment.php"]
   },
   "config": {

docs/migrate.md

@@ -0,0 +1,25 @@
+Defining and running migrations
+===============================
+
+The Migrate API delivers services for migrating data from a source system to Drupal 8. This API is provided by the core `migrate` module. In order to migrate data to Drupal, you'll need to create migrations for each type of destination data.
+
+These commands are an alternative to https://www.drupal.org/project/migrate_tools/. Dont use that module if you use these commands. Also, that module expects migrations to be defined as config entities whereas these commands expect migrations to be defined as YAML plugins (same as Drupal core).
+
+Defining migrations
+-------------------
+
+Learn how to create migrations from the Drupal official documentation:
+
+* Migrate API overview: https://www.drupal.org/docs/8/api/migrate-api/migrate-api-overview
+* Drupal API: https://api.drupal.org/api/drupal/core%21modules%21migrate%21migrate.api.php/group/migration
+
+Running migrations
+------------------
+
+Drush provides a set of commands that allows to run migration operations such as importing, checking the current status of migrations, rolling-back migrations, stopping an ongoing migration, etc. Such commands are available *only* when the `migrate` module is enabled. In order the get a full list of migrate commands, type:
+
+    drush --filter=migrate
+
+To get help on each command run drush with the command name as parameter and the `--help` option. For example next command will show details about the `migrate:import` Drush command:
+
+    drush migrate:import --help

src/Commands/core/DocsCommands.php

@@ -196,6 +196,18 @@ public function exampleCommand()
         self::printFileTopic($this->commandData);
     }
 
+    /**
+     * Defining and running migrations.
+     *
+     * @command docs:migrate
+     * @hidden
+     * @topic TBD
+     */
+    public function migrate()
+    {
+        self::printFileTopic($this->commandData);
+    }
+
     /**
      * Extend sql-sync to allow transfer of the sql dump file via http.
      *