{"action":"created","comment":{"url":"https://api.github.com/repos/openshift/origin/pulls/comments/34462183","id":34462183,"diff_hunk":"@@ -29,17 +34,303 @@ Common Flags\n | --insecure-skip-tls-verify | Skip SSL certificate validation (will make HTTPS insecure) |\n | --help (-h)                | Display help for specified command |\n \n-oc get\n------------\n+## Basic Commands\n+\n+### oc\n+\n+This displays the list of available commands.\n+\n+### oc login\n+\n+This retrieves a session token that allows you to act as a user.\n+Invoked without args, `oc login` prompts for a username and a password.\n+For example, these two invocations are identical:\n+\n+```bash\n+$ oc login\n+Username: test\n+Password: test\n+\n+$ oc login -u test -p test\n+```\n+\n+See also [`oc logout`](#oc-logout) and [`oc whoami`](#oc-whoami).\n+\n+### oc new-project\n+\n+This creates a new project, with you as the project admin.","path":"docs/cli.md","position":63,"original_position":63,"commit_id":"389bcd9e93c332b70f0ab3cb0a1713402573faa6","original_commit_id":"389bcd9e93c332b70f0ab3cb0a1713402573faa6","user":{"login":"soltysh","id":576341,"avatar_url":"https://avatars.githubusercontent.com/u/576341?v=3","gravatar_id":"","url":"https://api.github.com/users/soltysh","html_url":"https://github.com/soltysh","followers_url":"https://api.github.com/users/soltysh/followers","following_url":"https://api.github.com/users/soltysh/following{/other_user}","gists_url":"https://api.github.com/users/soltysh/gists{/gist_id}","starred_url":"https://api.github.com/users/soltysh/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/soltysh/subscriptions","organizations_url":"https://api.github.com/users/soltysh/orgs","repos_url":"https://api.github.com/users/soltysh/repos","events_url":"https://api.github.com/users/soltysh/events{/privacy}","received_events_url":"https://api.github.com/users/soltysh/received_events","type":"User","site_admin":false},"body":"s/with you/with current user\r\nor eventually with currently logged in user...","created_at":"2015-07-13T13:30:45Z","updated_at":"2015-07-13T13:30:45Z","html_url":"https://github.com/openshift/origin/pull/3559#discussion_r34462183","pull_request_url":"https://api.github.com/repos/openshift/origin/pulls/3559","_links":{"self":{"href":"https://api.github.com/repos/openshift/origin/pulls/comments/34462183"},"html":{"href":"https://github.com/openshift/origin/pull/3559#discussion_r34462183"},"pull_request":{"href":"https://api.github.com/repos/openshift/origin/pulls/3559"}}},"pull_request":{"url":"https://api.github.com/repos/openshift/origin/pulls/3559","id":39149430,"html_url":"https://github.com/openshift/origin/pull/3559","diff_url":"https://github.com/openshift/origin/pull/3559.diff","patch_url":"https://github.com/openshift/origin/pull/3559.patch","issue_url":"https://api.github.com/repos/openshift/origin/issues/3559","number":3559,"state":"open","locked":false,"title":"[docs] group cli commands; add missing ones","user":{"login":"tnguyen-rh","id":12084416,"avatar_url":"https://avatars.githubusercontent.com/u/12084416?v=3","gravatar_id":"","url":"https://api.github.com/users/tnguyen-rh","html_url":"https://github.com/tnguyen-rh","followers_url":"https://api.github.com/users/tnguyen-rh/followers","following_url":"https://api.github.com/users/tnguyen-rh/following{/other_user}","gists_url":"https://api.github.com/users/tnguyen-rh/gists{/gist_id}","starred_url":"https://api.github.com/users/tnguyen-rh/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tnguyen-rh/subscriptions","organizations_url":"https://api.github.com/users/tnguyen-rh/orgs","repos_url":"https://api.github.com/users/tnguyen-rh/repos","events_url":"https://api.github.com/users/tnguyen-rh/events{/privacy}","received_events_url":"https://api.github.com/users/tnguyen-rh/received_events","type":"User","site_admin":false},"body":"- add command groups headings as well as linked (toc-ish) intro blurb\r\n- use hash-at-bol instead of line of equal-signs/hyphens for heading markup\r\n- use backtick to markup hyphen (to mean stdin)\r\n- remove noisy ‘Examples’ headings\r\n- remove back-to-back codeblock, moving first one inline into intro blurb\r\n- zonk ‘oc namespace’ (per https://github.com/openshift/origin/issues/3165#issuecomment-114315963)\r\n- (oc login): add description, example\r\n- (oc logout): add description\r\n- (oc whoami): add description, example, \"see also\"\r\n- (oc volume): add description, example\r\n- (oc env): add description, example\r\n- (oc config): add \"synonym redirect\"\r\n- (oc export): add description, options table, example\r\n- (oc import-image): add description, example\r\n- (oc deploy): add description, examples\r\n- (oc rollback): add description, examples\r\n- (oc new-build): add description, component table, options table, example\r\n- (oc cancel-build): add description, example\r\n- (oc tag): add description, example\r\n- (oc edit): add description, options table, example\r\n- (oc exec): add \"synonym redirect\"\r\n- (oc port-forward): add \"synonym redirect\"\r\n- (oc proxy): add \"synonym redirect\"\r\n- (oc new-project): add description, example\r\n- (oc start-build): add \"see also\"\r\n- (oc new-app): add description, options table, example, \"see also\"\r\n- (oc status): add description, \"see also\"\r\n- (oc project): add description, example","created_at":"2015-07-03T06:36:50Z","updated_at":"2015-07-13T13:30:45Z","closed_at":null,"merged_at":null,"merge_commit_sha":"744e37f248f4d3b054d37b4b6353f582bbf4da61","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/openshift/origin/pulls/3559/commits","review_comments_url":"https://api.github.com/repos/openshift/origin/pulls/3559/comments","review_comment_url":"https://api.github.com/repos/openshift/origin/pulls/comments{/number}","comments_url":"https://api.github.com/repos/openshift/origin/issues/3559/comments","statuses_url":"https://api.github.com/repos/openshift/origin/statuses/389bcd9e93c332b70f0ab3cb0a1713402573faa6","head":{"label":"tnguyen-rh:doc-command-grouping","ref":"doc-command-grouping","sha":"389bcd9e93c332b70f0ab3cb0a1713402573faa6","user":{"login":"tnguyen-rh","id":12084416,"avatar_url":"https://avatars.githubusercontent.com/u/12084416?v=3","gravatar_id":"","url":"https://api.github.com/users/tnguyen-rh","html_url":"https://github.com/tnguyen-rh","followers_url":"https://api.github.com/users/tnguyen-rh/followers","following_url":"https://api.github.com/users/tnguyen-rh/following{/other_user}","gists_url":"https://api.github.com/users/tnguyen-rh/gists{/gist_id}","starred_url":"https://api.github.com/users/tnguyen-rh/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tnguyen-rh/subscriptions","organizations_url":"https://api.github.com/users/tnguyen-rh/orgs","repos_url":"https://api.github.com/users/tnguyen-rh/repos","events_url":"https://api.github.com/users/tnguyen-rh/events{/privacy}","received_events_url":"https://api.github.com/users/tnguyen-rh/received_events","type":"User","site_admin":false},"repo":{"id":37865384,"name":"origin","full_name":"tnguyen-rh/origin","owner":{"login":"tnguyen-rh","id":12084416,"avatar_url":"https://avatars.githubusercontent.com/u/12084416?v=3","gravatar_id":"","url":"https://api.github.com/users/tnguyen-rh","html_url":"https://github.com/tnguyen-rh","followers_url":"https://api.github.com/users/tnguyen-rh/followers","following_url":"https://api.github.com/users/tnguyen-rh/following{/other_user}","gists_url":"https://api.github.com/users/tnguyen-rh/gists{/gist_id}","starred_url":"https://api.github.com/users/tnguyen-rh/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tnguyen-rh/subscriptions","organizations_url":"https://api.github.com/users/tnguyen-rh/orgs","repos_url":"https://api.github.com/users/tnguyen-rh/repos","events_url":"https://api.github.com/users/tnguyen-rh/events{/privacy}","received_events_url":"https://api.github.com/users/tnguyen-rh/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/tnguyen-rh/origin","description":"OpenShift 3 - build, deploy, and manage your applications with Docker and Kubernetes","fork":true,"url":"https://api.github.com/repos/tnguyen-rh/origin","forks_url":"https://api.github.com/repos/tnguyen-rh/origin/forks","keys_url":"https://api.github.com/repos/tnguyen-rh/origin/keys{/key_id}","collaborators_url":"https://api.github.com/repos/tnguyen-rh/origin/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/tnguyen-rh/origin/teams","hooks_url":"https://api.github.com/repos/tnguyen-rh/origin/hooks","issue_events_url":"https://api.github.com/repos/tnguyen-rh/origin/issues/events{/number}","events_url":"https://api.github.com/repos/tnguyen-rh/origin/events","assignees_url":"https://api.github.com/repos/tnguyen-rh/origin/assignees{/user}","branches_url":"https://api.github.com/repos/tnguyen-rh/origin/branches{/branch}","tags_url":"https://api.github.com/repos/tnguyen-rh/origin/tags","blobs_url":"https://api.github.com/repos/tnguyen-rh/origin/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/tnguyen-rh/origin/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/tnguyen-rh/origin/git/refs{/sha}","trees_url":"https://api.github.com/repos/tnguyen-rh/origin/git/trees{/sha}","statuses_url":"https://api.github.com/repos/tnguyen-rh/origin/statuses/{sha}","languages_url":"https://api.github.com/repos/tnguyen-rh/origin/languages","stargazers_url":"https://api.github.com/repos/tnguyen-rh/origin/stargazers","contributors_url":"https://api.github.com/repos/tnguyen-rh/origin/contributors","subscribers_url":"https://api.github.com/repos/tnguyen-rh/origin/subscribers","subscription_url":"https://api.github.com/repos/tnguyen-rh/origin/subscription","commits_url":"https://api.github.com/repos/tnguyen-rh/origin/commits{/sha}","git_commits_url":"https://api.github.com/repos/tnguyen-rh/origin/git/commits{/sha}","comments_url":"https://api.github.com/repos/tnguyen-rh/origin/comments{/number}","issue_comment_url":"https://api.github.com/repos/tnguyen-rh/origin/issues/comments{/number}","contents_url":"https://api.github.com/repos/tnguyen-rh/origin/contents/{+path}","compare_url":"https://api.github.com/repos/tnguyen-rh/origin/compare/{base}...{head}","merges_url":"https://api.github.com/repos/tnguyen-rh/origin/merges","archive_url":"https://api.github.com/repos/tnguyen-rh/origin/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/tnguyen-rh/origin/downloads","issues_url":"https://api.github.com/repos/tnguyen-rh/origin/issues{/number}","pulls_url":"https://api.github.com/repos/tnguyen-rh/origin/pulls{/number}","milestones_url":"https://api.github.com/repos/tnguyen-rh/origin/milestones{/number}","notifications_url":"https://api.github.com/repos/tnguyen-rh/origin/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/tnguyen-rh/origin/labels{/name}","releases_url":"https://api.github.com/repos/tnguyen-rh/origin/releases{/id}","created_at":"2015-06-22T16:03:14Z","updated_at":"2015-06-22T16:03:21Z","pushed_at":"2015-07-13T12:47:21Z","git_url":"git://github.com/tnguyen-rh/origin.git","ssh_url":"git@github.com:tnguyen-rh/origin.git","clone_url":"https://github.com/tnguyen-rh/origin.git","svn_url":"https://github.com/tnguyen-rh/origin","homepage":"http://www.openshift.org","size":120105,"stargazers_count":0,"watchers_count":0,"language":"Go","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"openshift:master","ref":"master","sha":"9ff47c565130355cd8542a07f845526acad84192","user":{"login":"openshift","id":792337,"avatar_url":"https://avatars.githubusercontent.com/u/792337?v=3","gravatar_id":"","url":"https://api.github.com/users/openshift","html_url":"https://github.com/openshift","followers_url":"https://api.github.com/users/openshift/followers","following_url":"https://api.github.com/users/openshift/following{/other_user}","gists_url":"https://api.github.com/users/openshift/gists{/gist_id}","starred_url":"https://api.github.com/users/openshift/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openshift/subscriptions","organizations_url":"https://api.github.com/users/openshift/orgs","repos_url":"https://api.github.com/users/openshift/repos","events_url":"https://api.github.com/users/openshift/events{/privacy}","received_events_url":"https://api.github.com/users/openshift/received_events","type":"Organization","site_admin":false},"repo":{"id":22442668,"name":"origin","full_name":"openshift/origin","owner":{"login":"openshift","id":792337,"avatar_url":"https://avatars.githubusercontent.com/u/792337?v=3","gravatar_id":"","url":"https://api.github.com/users/openshift","html_url":"https://github.com/openshift","followers_url":"https://api.github.com/users/openshift/followers","following_url":"https://api.github.com/users/openshift/following{/other_user}","gists_url":"https://api.github.com/users/openshift/gists{/gist_id}","starred_url":"https://api.github.com/users/openshift/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openshift/subscriptions","organizations_url":"https://api.github.com/users/openshift/orgs","repos_url":"https://api.github.com/users/openshift/repos","events_url":"https://api.github.com/users/openshift/events{/privacy}","received_events_url":"https://api.github.com/users/openshift/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/openshift/origin","description":"OpenShift 3 - build, deploy, and manage your applications with Docker and Kubernetes","fork":false,"url":"https://api.github.com/repos/openshift/origin","forks_url":"https://api.github.com/repos/openshift/origin/forks","keys_url":"https://api.github.com/repos/openshift/origin/keys{/key_id}","collaborators_url":"https://api.github.com/repos/openshift/origin/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/openshift/origin/teams","hooks_url":"https://api.github.com/repos/openshift/origin/hooks","issue_events_url":"https://api.github.com/repos/openshift/origin/issues/events{/number}","events_url":"https://api.github.com/repos/openshift/origin/events","assignees_url":"https://api.github.com/repos/openshift/origin/assignees{/user}","branches_url":"https://api.github.com/repos/openshift/origin/branches{/branch}","tags_url":"https://api.github.com/repos/openshift/origin/tags","blobs_url":"https://api.github.com/repos/openshift/origin/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/openshift/origin/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/openshift/origin/git/refs{/sha}","trees_url":"https://api.github.com/repos/openshift/origin/git/trees{/sha}","statuses_url":"https://api.github.com/repos/openshift/origin/statuses/{sha}","languages_url":"https://api.github.com/repos/openshift/origin/languages","stargazers_url":"https://api.github.com/repos/openshift/origin/stargazers","contributors_url":"https://api.github.com/repos/openshift/origin/contributors","subscribers_url":"https://api.github.com/repos/openshift/origin/subscribers","subscription_url":"https://api.github.com/repos/openshift/origin/subscription","commits_url":"https://api.github.com/repos/openshift/origin/commits{/sha}","git_commits_url":"https://api.github.com/repos/openshift/origin/git/commits{/sha}","comments_url":"https://api.github.com/repos/openshift/origin/comments{/number}","issue_comment_url":"https://api.github.com/repos/openshift/origin/issues/comments{/number}","contents_url":"https://api.github.com/repos/openshift/origin/contents/{+path}","compare_url":"https://api.github.com/repos/openshift/origin/compare/{base}...{head}","merges_url":"https://api.github.com/repos/openshift/origin/merges","archive_url":"https://api.github.com/repos/openshift/origin/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/openshift/origin/downloads","issues_url":"https://api.github.com/repos/openshift/origin/issues{/number}","pulls_url":"https://api.github.com/repos/openshift/origin/pulls{/number}","milestones_url":"https://api.github.com/repos/openshift/origin/milestones{/number}","notifications_url":"https://api.github.com/repos/openshift/origin/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/openshift/origin/labels{/name}","releases_url":"https://api.github.com/repos/openshift/origin/releases{/id}","created_at":"2014-07-30T20:04:05Z","updated_at":"2015-07-13T11:32:31Z","pushed_at":"2015-07-13T13:21:19Z","git_url":"git://github.com/openshift/origin.git","ssh_url":"git@github.com:openshift/origin.git","clone_url":"https://github.com/openshift/origin.git","svn_url":"https://github.com/openshift/origin","homepage":"http://www.openshift.org","size":186159,"stargazers_count":542,"watchers_count":542,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":291,"mirror_url":null,"open_issues_count":410,"forks":291,"open_issues":410,"watchers":542,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/openshift/origin/pulls/3559"},"html":{"href":"https://github.com/openshift/origin/pull/3559"},"issue":{"href":"https://api.github.com/repos/openshift/origin/issues/3559"},"comments":{"href":"https://api.github.com/repos/openshift/origin/issues/3559/comments"},"review_comments":{"href":"https://api.github.com/repos/openshift/origin/pulls/3559/comments"},"review_comment":{"href":"https://api.github.com/repos/openshift/origin/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/openshift/origin/pulls/3559/commits"},"statuses":{"href":"https://api.github.com/repos/openshift/origin/statuses/389bcd9e93c332b70f0ab3cb0a1713402573faa6"}}}}