From e5f7a222153ffdf7c1e94ee2719b70e3d0a904b5 Mon Sep 17 00:00:00 2001 From: Brian Coca Date: Wed, 25 Jan 2017 10:51:51 -0500 Subject: [PATCH] clarified tag usage --- docs/docsite/rst/playbooks_tags.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/docsite/rst/playbooks_tags.rst b/docs/docsite/rst/playbooks_tags.rst index a9119577b83..68421c5cb43 100644 --- a/docs/docsite/rst/playbooks_tags.rst +++ b/docs/docsite/rst/playbooks_tags.rst @@ -1,10 +1,11 @@ Tags ==== -If you have a large playbook it may become useful to be able to run a -specific part of the configuration without running the whole playbook. +If you have a large playbook it may become useful to be able to run a specific part of the configuration without running the whole playbook. Both plays and tasks support a "tags:" attribute for this reason. +You can **ONLY** filter tasks based on tags from the command line with `--tags` or `--skip-tags`. +Adding "tags:" in any part of a play (including roles) adds those tags to the contained tasks. Example::