From 640131c464690d95d047b525e9b00f18baede85e Mon Sep 17 00:00:00 2001
From: Lujeni <julien@thebault.co>
Date: Fri, 14 Jul 2017 11:48:51 +0200
Subject: [PATCH] Missing documentation about the include directive for
 requirements files (#20090)

* Missing documentation about the include directive for requirements files

* Code block needs blank line

* Correct casing
---
 docs/docsite/rst/galaxy.rst | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/docs/docsite/rst/galaxy.rst b/docs/docsite/rst/galaxy.rst
index 0e9ec91259..07b041626f 100644
--- a/docs/docsite/rst/galaxy.rst
+++ b/docs/docsite/rst/galaxy.rst
@@ -134,6 +134,38 @@ Use the following example as a guide for specifying roles in *requirements.yml*:
       scm: git
       version: "0.1"  # quoted, so YAML doesn't parse this as a floating-point value
 
+Installing multiple roles from multiple files
+=============================================
+
+At a basic level, including requirements files allows you to break up bits of roles into smaller files. Role includes pull in roles from other files.
+
+Use the following command to install roles includes in *requirements.yml*  + *webserver,yml*
+
+::
+
+    ansible-galaxy install -r requirements.yml
+
+Content of the *requirements.yml* file:
+
+::
+
+    # from galaxy
+    - src: yatesr.timezone
+
+    - include: <path_to_requirements>/webserver.yml
+
+
+Content of the *webserver.yml* file:
+
+::
+
+    # from github
+    - src: https://github.com/bennojoy/nginx
+
+    # from Bitbucket
+    - src: git+http://bitbucket.org/willthames/git-ansible-galaxy
+      version: v1.4
+
 Dependencies
 ============