From 2dfff57f57ec87b35331bbe62ac21a26b8e33642 Mon Sep 17 00:00:00 2001 From: Christopher Torgalson Date: Thu, 30 Aug 2018 22:47:39 +0200 Subject: [PATCH] Extends 'which notation should I use' section in FAQ (#43729) * Extends 'which notation should I use' section in FAQ --- docs/docsite/rst/reference_appendices/faq.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/docsite/rst/reference_appendices/faq.rst b/docs/docsite/rst/reference_appendices/faq.rst index 039670fe06..262c98da47 100644 --- a/docs/docsite/rst/reference_appendices/faq.rst +++ b/docs/docsite/rst/reference_appendices/faq.rst @@ -452,8 +452,10 @@ Ansible supports dot notation and array notation for variables. Which notation s ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ The dot notation comes from Jinja and works fine for variables without special -characters. If your variable contains dots (.), colons (:), or dashes (-) it is -safer to use the array notation for variables. +characters. If your variable contains dots (.), colons (:), or dashes (-), if +a key begins and ends with two underscores, or if a key uses any of the known +public attributes, it is safer to use the array notation. See :ref:`playbooks_variables` +for a list of the known public attributes. .. code-block:: jinja