[openstack-dev] [Manila] Query on docstrings and method names

yang, xing xing.yang at emc.com
Thu Jun 26 15:39:37 UTC 2014


Hi Deepak,

I suggest that these two issues to be fixed in the current patch for the glusterfs driver first.  Then open another bug to fix them in other drivers in a different patch.

Thanks,
Xing



From: Deepak Shetty [mailto:dpkshetty at gmail.com]
Sent: Thursday, June 26, 2014 7:01 AM
To: OpenStack Development Mailing List (not for usage questions)
Subject: [openstack-dev] [Manila] Query on docstrings and method names

Hi All,
    With respect to the comment made by xian-yang @
https://review.openstack.org/#/c/102496/1/manila/share/drivers/glusterfs.py

for _update_share_status and the docstring that the method has, which is
"""Retrieve status info from share volume group."""
I have few questions based on the above...

1)      "share volume group" in docstring is incorrect, since its a glusterfs driver. But I think i know why it says volume group, probably because it came from lvm.py to begin with. I see that all other drivers also say volume group, tho' it may not be the right thing to say for their respective case.

Do we want to ensure that the docstrings are put in a way thats meaningful to the driver ?
2) _update_share_status method - I see the same issue here.. it says the same in all other drivers.. but as xian pointed, it should be rightfully called _update_share_stats. So should we wait for all driver to follow suit or start changing in the driver specific code as and when we touch that part of code ?
thanx,
deepak
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20140626/f1295b20/attachment.html>


More information about the OpenStack-dev mailing list