From d01ac3a0197e49c6c2090f7d97a33ffe5fcf9c3c Mon Sep 17 00:00:00 2001
From: Adam Johnson <me@adamj.eu>
Date: Sat, 4 Mar 2017 11:11:41 -0800
Subject: [PATCH] doc: Document --syntax-check flag for ansible-playbook
 (#22256)

It wasn't previously documented outside of the help / manpage, which made it less discoverable.
---
 docs/docsite/rst/playbooks_intro.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/docsite/rst/playbooks_intro.rst b/docs/docsite/rst/playbooks_intro.rst
index 6be2c1826ec..adeb5cbfd40 100644
--- a/docs/docsite/rst/playbooks_intro.rst
+++ b/docs/docsite/rst/playbooks_intro.rst
@@ -453,6 +453,9 @@ There's also a `clever playbook <https://github.com/ansible/ansible-examples/blo
 Tips and Tricks
 ```````````````
 
+To check the syntax of a playbook, use ``ansible-playbook`` with the ``--syntax-check`` flag. This will run the
+playbook file through the parser to ensure its included files, roles, etc. have no syntax problems.
+
 Look at the bottom of the playbook execution for a summary of the nodes that were targeted
 and how they performed.   General failures and fatal "unreachable" communication attempts are
 kept separate in the counts.