Merge pull request docker#631 from mstanleyjones/followup_link_flag

Misty Stanley-Jones · web-flow · commit 013d8f09fd92 · 2016-11-23T12:28:04.000-08:00
Add a little more clarification about --link
diff --git a/engine/userguide/networking/default_network/dockerlinks.md b/engine/userguide/networking/default_network/dockerlinks.md
@@ -21,7 +21,10 @@ detail on container linking in default `bridge` network.
 >**Warning**: The `--link` flag is a deprecated legacy feature of Docker. It may eventually
 be removed. Unless you absolutely need to continue using it, we recommend that you use
 user-defined networks to facilitate communication between two containers instead of using
-`--link`. 
+`--link`. One feature that user-defined networks do not support that you can do
+with `--link` is sharing environmental variables between containers. However,
+you can use other mechanisms such as volumes to share environment variables
+between containers in a more controlled way.
 
 ## Connect using network port mapping
 
