Merge pull request #12807 from Lujeni/devel

Ansible-galaxy requirements support a include directive

docsite/rst/galaxy.rst

@@ -68,6 +68,28 @@ To request specific versions (tags) of a role, use this syntax in the roles file
 
 Available versions will be listed on the Ansible Galaxy webpage for that role.
 
+Installing Multiple Roles From Multiple Files
+=============================================
+
+At a basic level, including requirements files allows you to break up bits of configuration policy into smaller files. Role includes pull in roles from other files.
+
+    ansible-galaxy install -r requirements.yml
+
+    # from galaxy
+    - src: yatesr.timezone
+
+    - include: webserver.yml
+
+
+Content of the webserver.yml file.
+
+    # from github
+    - src: https://github.com/bennojoy/nginx
+
+    # from github installing to a relative path
+    - src: https://github.com/bennojoy/nginx
+      path: vagrant/roles/
+
 Advanced Control over Role Requirements Files
 =============================================
 
@@ -385,19 +407,3 @@ Use the --remove option to disable and remove a Travis integration:
 Provide the ID of the integration you want disabled. Use the --list option to get the ID.
 
 
-
-
-
-
-
-
-
-
-
- 
-
-
-
-
-
-