summaryrefslogtreecommitdiffstats
path: root/examples/DOCUMENTATION.yml
blob: 86d577affc9869a08e37aad3096f59fd34979d96 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
---
# 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.
# See https://docs.ansible.com/ansible/devel/dev_guide/developing_modules_documenting.html for more information
#
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 (@awesome-github-id)"
options:
# One or more of the following
    option_name:
        description:
            - Description of the options goes here.
            - Must be written in sentences.
        required: true or false
        default: a string or the word null
        choices:
          - enable
          - disable
        aliases:
          - repo_name
        version_added: "1.X"
notes:
    - Other things consumers of your module should know.
requirements:
    - list of required things.
    - like the factor package
    - zypper >= 1.0