From 22d36791e985d0e78f6215bb46c6cd18bd7b719c Mon Sep 17 00:00:00 2001
From: Thomas Wiest <twiest@redhat.com>
Date: Wed, 24 Jun 2015 10:39:26 -0400
Subject: added .yml extension to style guide.

---
 docs/style_guide.adoc | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

(limited to 'docs/style_guide.adoc')

diff --git a/docs/style_guide.adoc b/docs/style_guide.adoc
index 7dc240f2e..2f89a5fae 100644
--- a/docs/style_guide.adoc
+++ b/docs/style_guide.adoc
@@ -43,6 +43,20 @@ This is a hard limit and is enforced by the build bot. This check MUST NOT be di
 
 == Ansible
 
+
+=== Ansible Yaml file extension
+'''
+[cols="2v,v"]
+|===
+| **Rule**
+| All Ansible Yaml files MUST have a .yml extension (and NOT .YML, .yaml etc).
+|===
+
+Ansible tooling (like `ansible-galaxy init`) create files with a .yml extension. Also, the Ansible documentation website references files with a .yml extension several times. Because of this, it is normal in the Ansible community to use a .yml extension for all Ansible Yaml files.
+
+Example: `tasks.yml`
+
+
 === Ansible Global Variables
 Ansible global variables are defined as any variables outside of ansible roles. Examples include playbook variables, variables passed in on the cli, etc.
 
-- 
cgit v1.2.1

