Usage
-----------
-Drush can be run in your shell by typing "drush" from within any Drupal root directory.
+Drush can be run in your shell by typing "drush" from within your project root directory or anywhere within Drupal.
$ drush [options] <command> [argument1] [argument2]
$ drush topic
-Options
+Using the --uri option and --root options.
-----------
-For multisite installations, use the --uri option to target a particular site. If
-you are outside the Drupal web root, you might need to use the --root, --uri or other
-command line options just for Drush to work.
+For multisite installations, use a site alias or the --uri option to target a particular site.
- $ drush --uri=http://example.com pm-updatecode
-
-If you wish to be able to select your Drupal site implicitly from the
-current working directory without using the --uri option, but you need your
-base_url to be set correctly, you may force it by setting the uri in
-a drushrc.php file located in the same directory as your settings.php file.
-
-```
-$options['uri'] = "http://example.com";
-```
+ $ drush --uri=http://example.com pm:enable
+
+If you are outside the Composer project and not using a site alias, you need to specify --root and --uri for Drush to locate and bootstrap the right Drupal site.
Site Aliases
------------
-Drush lets you run commands on a remote server, or even on a set of remote
-servers. Once defined, aliases can be referenced with the @ nomenclature, i.e.
+Drush lets you run commands on a remote server. Once defined, aliases can be referenced with the @ nomenclature, i.e.
```bash
# Run pending updates on staging site.
$ drush @staging updatedb
# Synchronize staging files to production
$ drush rsync @staging:%files/ @live:%files
-# Synchronize database from production to dev, excluding the cache table
-$ drush sql-sync --structure-tables-key=custom @live @dev
+# Synchronize database from production to local, excluding the cache table
+$ drush sql:sync --structure-tables-key=custom @live @self
```
-See [example.aliases.drushrc.php](https://raw.githubusercontent.com/drush-ops/drush/8.x/examples/example.aliases.drushrc.php) for more information.
+See [example.site.yml](https://raw.githubusercontent.com/drush-ops/drush/master/examples/example.site.yml) for more information.