Re: [openstack-dev] [python-novaclient] Better wording for secgroup-*-default-rules? help text

2015-03-10 Thread melanie witt
On Mar 10, 2015, at 19:28, Chris St. Pierre wrote: > Ah, look at that! In some other projects, flake8 complains about a docstring > whose first line doesn't end in a period, so I didn't think it'd be possible. > If you don't think that's excessively verbose, there'll be a patch in > shortly. T

Re: [openstack-dev] [python-novaclient] Better wording for secgroup-*-default-rules? help text

2015-03-10 Thread Chris St. Pierre
On Tue, Mar 10, 2015 at 4:50 PM, melanie witt wrote: > > I don't think your suggestion for the help text is excessively verbose. > There are already longer help texts for some commands than that, and I > think it's important to accurately explain what commands do. You can use a > multiline docstri

Re: [openstack-dev] [python-novaclient] Better wording for secgroup-*-default-rules? help text

2015-03-10 Thread melanie witt
On Mar 10, 2015, at 7:32, Chris St. Pierre wrote: > I've just filed a bug on the confusing wording of help text for the > secgroup-{add,delete,list}-default-rules? commands: > https://bugs.launchpad.net/python-novaclient/+bug/1430354 > > As I note in the bug, though, I'm not sure the best way

[openstack-dev] [python-novaclient] Better wording for secgroup-*-default-rules? help text

2015-03-10 Thread Chris St. Pierre
I've just filed a bug on the confusing wording of help text for the secgroup-{add,delete,list}-default-rules? commands: https://bugs.launchpad.net/python-novaclient/+bug/1430354 As I note in the bug, though, I'm not sure the best way to fix this. In an unconstrained world, I'd like to see somethin