[openstack-dev] openstack command line and --help for subcommands

Steve Martinelli stevemar at ca.ibm.com
Thu Jul 9 18:01:13 UTC 2015


Hey Sean, 1444983 has been reopened and assigned to you. Thanks!
https://bugs.launchpad.net/python-openstackclient/+bug/1444983

I am leaving 1251290 as invalid, since I feel it's a dupe of 1444983

Thanks,

Steve Martinelli
OpenStack Keystone Core



From:	"Perry, Sean" <sean.perry at hp.com>
To:	"OpenStack Development Mailing List (not for usage questions)"
            <openstack-dev at lists.openstack.org>
Date:	2015/07/09 12:12 PM
Subject:	Re: [openstack-dev] openstack command line and --help	for
            subcommands



Excellent. Can the tickets be assigned to me and re-opened?

From: Steve Martinelli [mailto:stevemar at ca.ibm.com]
Sent: Wednesday, July 08, 2015 8:28 PM
To: OpenStack Development Mailing List (not for usage questions)
Subject: Re: [openstack-dev] openstack command line and --help for
subcommands



Sean, Dean and I spoke about this at the last summit and we agreed that
--help should be included. I wanted to do this work item, but other
priorities came up, if you're happy to do the code, I'll be happy to review
it!

Thanks,

Steve Martinelli
OpenStack Keystone Core

Inactive hide details for "Perry, Sean" ---2015/07/08 07:53:37 PM---There
are two similar tickets marked as invalid: 1444983 an"Perry, Sean"
---2015/07/08 07:53:37 PM---There are two similar tickets marked as
invalid: 1444983 and 1251290. Both discuss the fact that 'op

From: "Perry, Sean" <sean.perry at hp.com>
To: "openstack-dev at lists.openstack.org" <openstack-dev at lists.openstack.org>
Date: 2015/07/08 07:53 PM
Subject: [openstack-dev] openstack command line and --help for subcommands




There are two similar tickets marked as invalid: 1444983 and 1251290. Both
discuss the fact that ?openstack subcommand function ?help? does not work.
Try ?openstack service list ?format foo?. You get the help output. It even
says that ?h provides help. But it is ignored and you get the global help.
That is not good UX. Both tickets are closed because ?openstack help
service list? is supposed to be the proper usage. It is my opinion that is
wrong. Users actually expect ?help to work as witnessed by two tickets over
3 years. Others like me would have opened a ticket had they not found the
existing one. If using the help verb is the only way to get help then the
help output needs to stop recommending ?h. But really, the help verb should
list the possible verbs and ?help should be used for the individual
subcommands. This is how many, many other CLIs work so admins the world
over expect it.

Yes, I will step up and do the coding if the patch will be accepted.

If there is some other place to argue the UX aspects please direct me
there.

 __________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150709/45e84d06/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: graycol.gif
Type: image/gif
Size: 105 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150709/45e84d06/attachment.gif>


More information about the OpenStack-dev mailing list