Update docs for refeactor to https://github.com/consolidation/site-alias

Author: weitzman

docs/site-alias-manager.md

@@ -1,11 +1,12 @@
 Site Alias Manager
 ==================
 
-The [Site Alias Manager (SAM)](https://github.com/drush-ops/drush/blob/master/src/SiteAlias/SiteAliasManager.php) service is used to retrieve information about one or all of the site aliases for the current installation.
+The [Site Alias Manager (SAM)](https://github.com/consolidation/site-alias/blob/master/src/SiteAliasManager.php) service is used to retrieve information about one or all of the site aliases for the current installation.
 
 - An informative example is the [browse command](https://github.com/drush-ops/drush/blob/master/src/Commands/core/BrowseCommands.php)
 - A commandfile gets access to the SAM by implementing the SiteAliasManagerAwareInterface and *use*ing the SiteAliasManagerAwareTrait trait. Then you gain access via `$this->siteAliasManager()`.
 - If an alias was used for the current request, it is available via $this->siteAliasManager()->getself().
-- The SAM generally deals in [AliasRecord](https://github.com/drush-ops/drush/blob/master/src/SiteAlias/AliasRecord.php) objects. That is how any given site alias is represented. See its methods for determining things like whether the alias points to a local host or remote host.
+- The SAM generally deals in [AliasRecord](https://github.com/consolidation/site-alias/blob/master/src/AliasRecord.php) objects. That is how any given site alias is represented. See its methods for determining things like whether the alias points to a local host or remote host.
 - [An example site alias file](https://raw.githubusercontent.com/drush-ops/drush/master/examples/example.site.yml).
 - [Dynamically alter site aliases](https://raw.githubusercontent.com/drush-ops/drush/master/examples/Commands/SiteAliasAlterCommands.php).
+- The SAM is also available for as [a standalone Composer project](https://github.com/consolidation/site-alias). More information available in the README there.

examples/example.site.yml

@@ -4,8 +4,6 @@
 # To convert legacy alias (*.aliases.drushrc.php) to yml, run the
 # site:alias-convert command.
 #
-# Use this file as a guide to creating your own aliases.
-#
 # Aliases are commonly used to define short names for
 # local or remote Drupal installations; however, an alias
 # is really nothing more than a collection of options.
@@ -184,6 +182,8 @@
 # It is no longer possible to set environment variables from within an alias.
 # This is a planned feature.
 #
+# See https://github.com/consolidation/site-alias for more developer information about Site Aliases.
+#
 # An example appears below. Edit to suit and remove the @code / @endcode and
 # leading hashes to enable.
 #