Currently the Python code documentation is not being published at all
which can be observed by visiting
https://docs.openstack.org/neutron-lib/latest/genindex.html
This used to work in the old versions, for example in 1.9.1:
https: //docs.openstack.org/neutron-lib/1.9.1/genindex.html
Docstring fixes in placement/utils.py:
When Sphinx generates documentation, it produces following warning:
"WARNING: Definition list ends without a blank line; unexpected unindent.""
This commit adds the missing lines, but also switches to :: so that
contents of the definitions are treated as raw text.
Change-Id: Ibb919c53d7e1bc2710e85ae86a0ed0d7620a900c
d69eae326e