New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
doc/mgr: document facilities methods using automethod
directive
#18680
Conversation
also update the docstring to confirm to http://www.sphinx-doc.org/en/stable/domains.html#info-field-lists. Signed-off-by: Kefu Chai <kchai@redhat.com>
Signed-off-by: Kefu Chai <kchai@redhat.com>
""" | ||
return self._ceph_get_server(None) | ||
|
||
def get_metadata(self, svc_type, svc_id): | ||
""" | ||
Fetch the metadata for a particular service. | ||
Fetch the daemon metadata for a particular service. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hay, @tchaikov , It would be better to put docstring following """
, for example:
def complex(real=0.0, imag=0.0):
"""Form a complex number.
Keyword arguments:
real -- the real part (default 0.0)
imag -- the imaginary part (default 0.0)
"""
if imag == 0.0 and real == 0.0:
return complex_zero
...
see python's docstring pep: https://www.python.org/dev/peps/pep-0257/
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
i am trying to focus on what this PR addresses, instead of the compliance to pep-257 .
also,
"""
Form a complex number.
...
"""
is more consistent with the python code in Ceph.
jenkins render docs |
Doc render available at http://docs.ceph.com/ceph-prs/18680/ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice!
No description provided.