Commit 0748e86f by Michael DeHaan

Fix documentation about examples in modules so folks use the new style.

parent cdda88fd
......@@ -353,15 +353,10 @@ syntax highlighting before you include it in your Python file.
Example
+++++++
Here's a correctly formatted YAML document we could use for a
``DOCUMENTATION`` string:
To print a basic documentation string, run ``./hacking/module_formatter.py -G``.
.. literalinclude:: ../../examples/DOCUMENTATION.yaml
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.
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::
......
......@@ -27,7 +27,3 @@ options:
choices: [list, of, choices]
aliases: [list, of, aliases]
version_added: 0.X
examples:
# One or more of the following:
- code: modulename opt1=arg1 opt2=arg2
description: Optional words describing this example
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment