summaryrefslogtreecommitdiff
path: root/examples/DOCUMENTATION.yml
diff options
context:
space:
mode:
authorMichael DeHaan <michael@ansibleworks.com>2013-12-25 11:45:27 -0500
committerMichael DeHaan <michael@ansibleworks.com>2013-12-25 13:24:29 -0500
commit31d0060de825d80424099ae05b128d6abfc22f05 (patch)
treef0a2ca863af8cdf43a900ce65f9fd53cc8d50ed3 /examples/DOCUMENTATION.yml
parent10009b0d3fb4321df105b7a10b0a46e465e230fe (diff)
downloadansible-31d0060de825d80424099ae05b128d6abfc22f05.tar.gz
Standardized on yml suffix, so fix this example content filename.
Diffstat (limited to 'examples/DOCUMENTATION.yml')
-rw-r--r--examples/DOCUMENTATION.yml29
1 files changed, 29 insertions, 0 deletions
diff --git a/examples/DOCUMENTATION.yml b/examples/DOCUMENTATION.yml
new file mode 100644
index 0000000000..05e248edfd
--- /dev/null
+++ b/examples/DOCUMENTATION.yml
@@ -0,0 +1,29 @@
+---
+# If a key doesn't apply to your module (ex: choices, default, or
+# aliases) you can use the word 'null', or an empty list, [], where
+# appropriate.
+module: modulename
+short_description: This is a sentence describing the module
+description:
+ - Longer description of the module
+ - You might include instructions
+version_added: "X.Y"
+author: Your AWESOME name here
+notes:
+ - Other things consumers of your module should know
+requirements:
+ - list of required things
+ - like the factor package
+ - or a specic platform
+options:
+# One or more of the following
+ option_name:
+ description:
+ - Words go here
+ - that describe
+ - this option
+ required: true or false
+ default: a string or the word null
+ choices: [list, of, choices]
+ aliases: [list, of, aliases]
+ version_added: 1.X