Fixing module docs so they dont show up as a list on ansible docs.

[jmighion]

SUMMARY

The docs for these 2 modules showed every character as a list on http://docs.ansible.com/

ISSUE TYPE

• Bugfix Pull Request

COMPONENT NAME

panos_nat_rule, panos_object

ANSIBLE VERSION

ansible 2.4.4 (panos_docs 878030c073) last updated 2018/03/08 08:54:32 (GMT -700)
  config file = None
  configured module search path = [u'/Users/james/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules']
  ansible python module location = /Users/james/Documents/git/ansible/lib/ansible
  executable location = /Users/james/Documents/git/ansible/bin/ansible
  python version = 2.7.14 (default, Feb  6 2018, 20:04:00) [GCC 4.2.1 Compatible Apple LLVM 9.0.0 (clang-900.0.39.2)]

[ansibot]

The test ansible-test sanity --test ansible-doc --python 2.7 [?] failed with the following error:

Command "ansible-doc panos_nat_rule panos_object" returned exit status 1.
>>> Standard Error
ERROR! module panos_nat_rule missing documentation (or could not parse documentation): Parsing produced an empty object.

The test ansible-test sanity --test ansible-doc --python 3.5 [?] failed with the following error:

Command "ansible-doc panos_nat_rule panos_object" returned exit status 1.
>>> Standard Error
ERROR! module panos_nat_rule missing documentation (or could not parse documentation): Parsing produced an empty object.

The test ansible-test sanity --test ansible-doc --python 2.6 [?] failed with the following error:

Command "ansible-doc panos_nat_rule panos_object" returned exit status 1.
>>> Standard Error
ERROR! module panos_nat_rule missing documentation (or could not parse documentation): Parsing produced an empty object.

The test ansible-test sanity --test ansible-doc --python 3.6 [?] failed with the following error:

Command "ansible-doc panos_nat_rule panos_object" returned exit status 1.
>>> Standard Error
ERROR! module panos_nat_rule missing documentation (or could not parse documentation): Parsing produced an empty object.

The test ansible-test sanity --test validate-modules [?] failed with the following errors:

lib/ansible/modules/network/panos/panos_nat_rule.py:17:1: E302 DOCUMENTATION is not valid YAML
lib/ansible/modules/network/panos/panos_object.py:34:1: E302 DOCUMENTATION is not valid YAML

click here for bot help

[ansibot]

cc @ivanbojer @jtschichold @rnh556
click here for bot help

[abadger]

@jmighion One note for the future: please make Pull requests against devel first. Then we can cherry-pick (via PR or otherwise) after it's merged to devel. Committing to the stable branches first runs the risk of people not realizing that the change is not yet merged to devel and therefore the problem will come back on the next major release.

[gundalow]

Oh, that's my fault. Seems to be OK in 2.5 & devel. I think the docs/template/ was updated to deal with it when the rst&html is generated.