From ad1a7d90ff4c98981e5daf38cccd261c7e5bb473 Mon Sep 17 00:00:00 2001 From: Ken Celenza Date: Wed, 16 May 2018 12:19:21 -0400 Subject: [PATCH] Update structure to include file extensions (#36967) * Update structure to include file extensions It is not clear to novice users that the host/group_vars files should be yaml files. This highlights that IMHO a bit more clearer. * pluralize --- .../user_guide/playbooks_best_practices.rst | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/docsite/rst/user_guide/playbooks_best_practices.rst b/docs/docsite/rst/user_guide/playbooks_best_practices.rst index 9326e429f7c..cdb70e85cf1 100644 --- a/docs/docsite/rst/user_guide/playbooks_best_practices.rst +++ b/docs/docsite/rst/user_guide/playbooks_best_practices.rst @@ -32,11 +32,11 @@ The top level of the directory would contain files and directories like so:: staging # inventory file for staging environment group_vars/ - group1 # here we assign variables to particular groups - group2 # "" + group1.yml # here we assign variables to particular groups + group2.yml host_vars/ - hostname1 # if systems need specific variables, put them here - hostname2 # "" + hostname1.yml # here we assign variables to particular systems + hostname2.yml library/ # if any custom modules, put them here (optional) module_utils/ # if any custom module_utils to support modules, put them here (optional) @@ -84,20 +84,20 @@ Alternatively you can put each inventory file with its ``group_vars``/``host_var production/ hosts # inventory file for production servers group_vars/ - group1 # here we assign variables to particular groups - group2 # "" + group1.yml # here we assign variables to particular groups + group2.yml host_vars/ - hostname1 # if systems need specific variables, put them here - hostname2 # "" + hostname1.yml # here we assign variables to particular systems + hostname2.yml staging/ hosts # inventory file for staging environment group_vars/ - group1 # here we assign variables to particular groups - group2 # "" + group1.yml # here we assign variables to particular groups + group2.yml host_vars/ - stagehost1 # if systems need specific variables, put them here - stagehost2 # "" + stagehost1.yml # here we assign variables to particular systems + stagehost2.yml library/ module_utils/