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:dpkshe...@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
_______________________________________________
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

Reply via email to