{"action":"created","issue":{"url":"https://api.github.com/repos/openshift/origin/issues/4226","labels_url":"https://api.github.com/repos/openshift/origin/issues/4226/labels{/name}","comments_url":"https://api.github.com/repos/openshift/origin/issues/4226/comments","events_url":"https://api.github.com/repos/openshift/origin/issues/4226/events","html_url":"https://github.com/openshift/origin/issues/4226","id":101516299,"number":4226,"title":"Inconsistencies in command names and its subcommands trees","user":{"login":"fabianofranz","id":158611,"avatar_url":"https://avatars.githubusercontent.com/u/158611?v=3","gravatar_id":"","url":"https://api.github.com/users/fabianofranz","html_url":"https://github.com/fabianofranz","followers_url":"https://api.github.com/users/fabianofranz/followers","following_url":"https://api.github.com/users/fabianofranz/following{/other_user}","gists_url":"https://api.github.com/users/fabianofranz/gists{/gist_id}","starred_url":"https://api.github.com/users/fabianofranz/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/fabianofranz/subscriptions","organizations_url":"https://api.github.com/users/fabianofranz/orgs","repos_url":"https://api.github.com/users/fabianofranz/repos","events_url":"https://api.github.com/users/fabianofranz/events{/privacy}","received_events_url":"https://api.github.com/users/fabianofranz/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/openshift/origin/labels/area/usability","name":"area/usability","color":"006b75"},{"url":"https://api.github.com/repos/openshift/origin/labels/component/cli","name":"component/cli","color":"0052cc"},{"url":"https://api.github.com/repos/openshift/origin/labels/kind/enhancement","name":"kind/enhancement","color":"84b6eb"},{"url":"https://api.github.com/repos/openshift/origin/labels/priority/P2","name":"priority/P2","color":"fbca04"}],"state":"open","locked":false,"assignee":{"login":"fabianofranz","id":158611,"avatar_url":"https://avatars.githubusercontent.com/u/158611?v=3","gravatar_id":"","url":"https://api.github.com/users/fabianofranz","html_url":"https://github.com/fabianofranz","followers_url":"https://api.github.com/users/fabianofranz/followers","following_url":"https://api.github.com/users/fabianofranz/following{/other_user}","gists_url":"https://api.github.com/users/fabianofranz/gists{/gist_id}","starred_url":"https://api.github.com/users/fabianofranz/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/fabianofranz/subscriptions","organizations_url":"https://api.github.com/users/fabianofranz/orgs","repos_url":"https://api.github.com/users/fabianofranz/repos","events_url":"https://api.github.com/users/fabianofranz/events{/privacy}","received_events_url":"https://api.github.com/users/fabianofranz/received_events","type":"User","site_admin":false},"milestone":null,"comments":13,"created_at":"2015-08-17T21:43:02Z","updated_at":"2015-08-18T18:14:36Z","closed_at":null,"body":"From discussions in the CLI Design meetings. \r\n\r\nWe need to address some inconsistencies in \r\n* command names - some use nouns in singular and others in plural\r\n* subcommands or flags for sub-actions of grouping commands (e.g. `noun list`, `noun --list`, or even `nouns`).\r\n\r\nExamples of current inconsistencies\r\n* `oc secrets new|add|...` (grouping command, *plural* but handle one secret at a time)\r\n* `oc volume --add|--list|...` (relies on flags not grouping, singular)\r\n* `oc label` (not grouping, *singular* but can take multiple labels in one command call. it's also a verb)\r\n* `oadm groups new|add-users|...` (grouping command, *plural* but manage one group at a time)\r\n* `oadm policy add-role-to-user|remove-user|...` (grouping command, singular)\r\n\r\nSometimes nouns are also verbs (label, group, etc).\r\n\r\n**We don't necessarily need to come up with one strategy to rule them all, but some more consistency should be good.** We learned from `rhc` that having too many aliases lead to a lot of confusion, but one of the better accepted proposals would be:\r\n* all nouns in plural by default (in help)\r\n* but also accepting singular\r\n* that's how resource names work (e.g. `oc get pod` and `oc get pods`)\r\n* e.g. `oc secret` and `oc secret`\r\n\r\nAlso related: https://trello.com/c/Jo4V19Bf/633-unify-build-commands-with-deployments\r\n\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/openshift/origin/issues/comments/132304828","html_url":"https://github.com/openshift/origin/issues/4226#issuecomment-132304828","issue_url":"https://api.github.com/repos/openshift/origin/issues/4226","id":132304828,"user":{"login":"fabianofranz","id":158611,"avatar_url":"https://avatars.githubusercontent.com/u/158611?v=3","gravatar_id":"","url":"https://api.github.com/users/fabianofranz","html_url":"https://github.com/fabianofranz","followers_url":"https://api.github.com/users/fabianofranz/followers","following_url":"https://api.github.com/users/fabianofranz/following{/other_user}","gists_url":"https://api.github.com/users/fabianofranz/gists{/gist_id}","starred_url":"https://api.github.com/users/fabianofranz/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/fabianofranz/subscriptions","organizations_url":"https://api.github.com/users/fabianofranz/orgs","repos_url":"https://api.github.com/users/fabianofranz/repos","events_url":"https://api.github.com/users/fabianofranz/events{/privacy}","received_events_url":"https://api.github.com/users/fabianofranz/received_events","type":"User","site_admin":false},"created_at":"2015-08-18T18:14:36Z","updated_at":"2015-08-18T18:14:36Z","body":"If we decide to tolerate both, then the argument for what we show in help can be cohesion/fluency, decided for each case individually. E.g.: `secret` and `group` because you manage once at a time, `labels` because multiple at a time or `label` if we see it more like a verb, etc."}}