summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorscottb <dharmabumstead@users.noreply.github.com>2017-06-06 14:19:18 -0700
committerGitHub <noreply@github.com>2017-06-06 14:19:18 -0700
commitf704222dc1945a616e1fff1d051b1d27a5ee6ece (patch)
tree6a9f6e039d9d44f1f692d8feba8bd0ca09092bc0
parent89e54c5a45ebd156c8b0cf71df3d9bae63c479e3 (diff)
downloadansible-imports_and_includes.tar.gz
Edits for clarityimports_and_includes
-rw-r--r--docs/docsite/rst/playbooks_reuse_includes.rst13
1 files changed, 6 insertions, 7 deletions
diff --git a/docs/docsite/rst/playbooks_reuse_includes.rst b/docs/docsite/rst/playbooks_reuse_includes.rst
index 48c28aa25c..98e934ba9d 100644
--- a/docs/docsite/rst/playbooks_reuse_includes.rst
+++ b/docs/docsite/rst/playbooks_reuse_includes.rst
@@ -11,12 +11,12 @@ As noted in :doc:`playbooks_reuse`, include and import statements are very simil
- All ``import*`` statements are pre-processed at the time playbooks are parsed.
- All ``include*`` statements are processed as they encountered during the execution of the playbook.
-Please refer to above for documentation concerning the trade-offs one may encounter when using each type.
+Please refer to :doc:`playbooks_reuse` for documentation concerning the trade-offs one may encounter when using each type.
Importing Playbooks
```````````````````
-It is possible to include playbooks inside a master playbook, as follows::
+It is possible to include playbooks inside a master playbook. For example::
---
import_playbook: webservers.yml
@@ -51,7 +51,7 @@ You can also pass variables into imports and includes::
- import_tasks: wordpress.yml wp_user=alice
- import_tasks: wordpress.yml wp_user=bob
-Starting in Ansible 1.0, variables can also be passed to include files using an alternative syntax, which also supports structured variables like dictionaries and lists::
+Variables can also be passed to include files using an alternative syntax, which also supports structured variables like dictionaries and lists::
tasks:
- include_tasks: wordpress.yml
@@ -63,13 +63,12 @@ Starting in Ansible 1.0, variables can also be passed to include files using an
Using either syntax, variables passed in can then be used in the included files. These variables will only be available to tasks within the included file. See :doc:`variable_precedence` for more details on variable inheritance and precedence.
-.. note::
- As of 1.0, task include statements can be used at arbitrary depth. They were previously limited to a single level, so task includes could not include other files containing task includes.
+Task include statements can be used at arbitrary depth.
.. note::
- The static and dynamic can be mixed, however this is not recommended as it may lead to difficult-to-diagnose bugs in your playbooks.
+ Static and dynamic can be mixed, however this is not recommended as it may lead to difficult-to-diagnose bugs in your playbooks.
-Includes and imports can also be used in the ``handlers:`` section, for instance, if you want to define how to restart apache, you only have to do that once for all of your playbooks. You might make a handlers.yml that looks like::
+Includes and imports can also be used in the ``handlers:`` section; for instance, if you want to define how to restart apache, you only have to do that once for all of your playbooks. You might make a handlers.yml that looks like::
# more_handlers.yml
---