{"action":"created","issue":{"url":"https://api.github.com/repos/learningequality/kolibri/issues/3727","repository_url":"https://api.github.com/repos/learningequality/kolibri","labels_url":"https://api.github.com/repos/learningequality/kolibri/issues/3727/labels{/name}","comments_url":"https://api.github.com/repos/learningequality/kolibri/issues/3727/comments","events_url":"https://api.github.com/repos/learningequality/kolibri/issues/3727/events","html_url":"https://github.com/learningequality/kolibri/issues/3727","id":327935062,"node_id":"MDU6SXNzdWUzMjc5MzUwNjI=","number":3727,"title":"define conventions for kolibri manage commands","user":{"login":"indirectlylit","id":2367265,"node_id":"MDQ6VXNlcjIzNjcyNjU=","avatar_url":"https://avatars2.githubusercontent.com/u/2367265?v=4","gravatar_id":"","url":"https://api.github.com/users/indirectlylit","html_url":"https://github.com/indirectlylit","followers_url":"https://api.github.com/users/indirectlylit/followers","following_url":"https://api.github.com/users/indirectlylit/following{/other_user}","gists_url":"https://api.github.com/users/indirectlylit/gists{/gist_id}","starred_url":"https://api.github.com/users/indirectlylit/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/indirectlylit/subscriptions","organizations_url":"https://api.github.com/users/indirectlylit/orgs","repos_url":"https://api.github.com/users/indirectlylit/repos","events_url":"https://api.github.com/users/indirectlylit/events{/privacy}","received_events_url":"https://api.github.com/users/indirectlylit/received_events","type":"User","site_admin":false},"labels":[{"id":492816641,"node_id":"MDU6TGFiZWw0OTI4MTY2NDE=","url":"https://api.github.com/repos/learningequality/kolibri/labels/TASK:%20tech%20update","name":"TASK: tech update","color":"72486f","default":false},{"id":492816719,"node_id":"MDU6TGFiZWw0OTI4MTY3MTk=","url":"https://api.github.com/repos/learningequality/kolibri/labels/TASK:%20ux%20update","name":"TASK: ux update","color":"72486f","default":false}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2018-05-30T23:32:01Z","updated_at":"2018-06-05T03:16:26Z","closed_at":null,"author_association":"MEMBER","body":"### Observed behavior\r\n\r\nLet's decide on conventions for manage commands.\r\n\r\nTwo recent examples:\r\n\r\n* https://github.com/learningequality/kolibri/pull/3594#issuecomment-388210709\r\n* https://github.com/learningequality/kolibri/pull/3619#pullrequestreview-119193589\r\n\r\nOther inconsistencies:\r\n\r\n* shell\r\n* plugin\r\n* some older commands\r\n\r\n### Expected behavior\r\n\r\ncommands are consistent\r\n\r\n### User-facing consequences\r\n\r\nnot too much at the moment, but longer-term we want a clean command-line UI\r\n\r\n\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/learningequality/kolibri/issues/comments/394568065","html_url":"https://github.com/learningequality/kolibri/issues/3727#issuecomment-394568065","issue_url":"https://api.github.com/repos/learningequality/kolibri/issues/3727","id":394568065,"node_id":"MDEyOklzc3VlQ29tbWVudDM5NDU2ODA2NQ==","user":{"login":"indirectlylit","id":2367265,"node_id":"MDQ6VXNlcjIzNjcyNjU=","avatar_url":"https://avatars2.githubusercontent.com/u/2367265?v=4","gravatar_id":"","url":"https://api.github.com/users/indirectlylit","html_url":"https://github.com/indirectlylit","followers_url":"https://api.github.com/users/indirectlylit/followers","following_url":"https://api.github.com/users/indirectlylit/following{/other_user}","gists_url":"https://api.github.com/users/indirectlylit/gists{/gist_id}","starred_url":"https://api.github.com/users/indirectlylit/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/indirectlylit/subscriptions","organizations_url":"https://api.github.com/users/indirectlylit/orgs","repos_url":"https://api.github.com/users/indirectlylit/repos","events_url":"https://api.github.com/users/indirectlylit/events{/privacy}","received_events_url":"https://api.github.com/users/indirectlylit/received_events","type":"User","site_admin":false},"created_at":"2018-06-05T03:16:25Z","updated_at":"2018-06-05T03:16:25Z","author_association":"MEMBER","body":"In #3594 we decided to use the command \r\n\r\n```bash\r\nkolibri manage content movedirectory\r\n```\r\n\r\nAt the risk of bike-shedding that decision, I wanted to propose one convention update before committing to it:\r\n\r\n> Multi-word commands should be `snake_case`.\r\n\r\nIn this case, the command would become `kolibri manage content move_directory`\r\n\r\nMashing multiple words together without any clear separator makes them hard to read, which is especially problematic because we won't be internationalizing the commands any time soon.\r\n\r\n(In this case, the command scans to me like \"moved irectory\")\r\n\r\n"}}
{"actor":{"display_login":"indirectlylit"}}