Fix documentation about examples in modules so folks use the new style.
parent
cdda88fda7
commit
0748e86f0e
|
@ -353,15 +353,10 @@ syntax highlighting before you include it in your Python file.
|
||||||
Example
|
Example
|
||||||
+++++++
|
+++++++
|
||||||
|
|
||||||
Here's a correctly formatted YAML document we could use for a
|
To print a basic documentation string, run ``./hacking/module_formatter.py -G``.
|
||||||
``DOCUMENTATION`` string:
|
|
||||||
|
|
||||||
.. literalinclude:: ../../examples/DOCUMENTATION.yaml
|
You can copy it into your module and use it as a starting point
|
||||||
|
when writing your own docs.
|
||||||
This is available in the 'examples/' directory of the of the Ansible
|
|
||||||
github repository, and you can have that generated with
|
|
||||||
``./hacking/module_formatter.py -G``. You can copy it into your module and use
|
|
||||||
it as a starting point when writing your own docs.
|
|
||||||
|
|
||||||
Include it in your module file like this::
|
Include it in your module file like this::
|
||||||
|
|
||||||
|
|
|
@ -27,7 +27,3 @@ options:
|
||||||
choices: [list, of, choices]
|
choices: [list, of, choices]
|
||||||
aliases: [list, of, aliases]
|
aliases: [list, of, aliases]
|
||||||
version_added: 0.X
|
version_added: 0.X
|
||||||
examples:
|
|
||||||
# One or more of the following:
|
|
||||||
- code: modulename opt1=arg1 opt2=arg2
|
|
||||||
description: Optional words describing this example
|
|
||||||
|
|
Loading…
Reference in New Issue