{"action":"created","comment":{"url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/comments/84381999","pull_request_review_id":5164758,"id":84381999,"diff_hunk":"@@ -0,0 +1,34 @@\n+# V1 API\n+\n+This document contains the Kubernetes resource types for the v1 service catalog.\n+\n+# Resource Types\n+\n+This section lists descriptions of Kubernetes resource types.\n+\n+## `ServiceClass`\n+\n+This resource indicates a general kind of backing service that a consumer\n+may request. The 'service kind' concept is purposefully arbitrary. We expect\n+each cluster operator team to assign specific meaning to the ones they choose.\n+\n+## `ServiceInstance`\n+\n+This resource indicates that a request by a consumer for a usable `ServiceClass`\n+has been successfully executed. Consumers may reference these resources to\n+begin using the backing service it represents.\n+\n+## `ServiceInstanceClaim`\n+\n+This resource is used by the consumer to get credentials for the backing service\n+that a pre-existing `ServiceInstance` represents.\n+\n+The byproducts of a successfully executed claim will be binding information\n+in the form of other, standard Kubernetes resources. We expect these to be\n+`ConfigMap`s and `Secret`s initially, but the number and types of these\n+resources will be implementation-dependent. The claim will contain\n+Kubernetes-style reference links for each Kubernetes resource that was created\n+upon successful execution.\n+\n+Successfully executed claims will also serve as a record of an application that's\n+bound to a backing service.","path":"docs/v1/api.md","position":34,"original_position":34,"commit_id":"ad4bd23cc423a024ddf165d597b62858b22bae40","original_commit_id":"ad4bd23cc423a024ddf165d597b62858b22bae40","user":{"login":"pmorie","id":366488,"avatar_url":"https://avatars.githubusercontent.com/u/366488?v=3","gravatar_id":"","url":"https://api.github.com/users/pmorie","html_url":"https://github.com/pmorie","followers_url":"https://api.github.com/users/pmorie/followers","following_url":"https://api.github.com/users/pmorie/following{/other_user}","gists_url":"https://api.github.com/users/pmorie/gists{/gist_id}","starred_url":"https://api.github.com/users/pmorie/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pmorie/subscriptions","organizations_url":"https://api.github.com/users/pmorie/orgs","repos_url":"https://api.github.com/users/pmorie/repos","events_url":"https://api.github.com/users/pmorie/events{/privacy}","received_events_url":"https://api.github.com/users/pmorie/received_events","type":"User","site_admin":false},"body":"@krancour I think it is best if we don't get prescriptive about that for now and add it later.  It's easier to get pieces everyone agrees on in first.","created_at":"2016-10-20T21:42:08Z","updated_at":"2016-10-20T21:42:09Z","html_url":"https://github.com/kubernetes-incubator/service-catalog/pull/16#discussion_r84381999","pull_request_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/16","_links":{"self":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/comments/84381999"},"html":{"href":"https://github.com/kubernetes-incubator/service-catalog/pull/16#discussion_r84381999"},"pull_request":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/16"}}},"pull_request":{"url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/16","id":90096171,"html_url":"https://github.com/kubernetes-incubator/service-catalog/pull/16","diff_url":"https://github.com/kubernetes-incubator/service-catalog/pull/16.diff","patch_url":"https://github.com/kubernetes-incubator/service-catalog/pull/16.patch","issue_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues/16","number":16,"state":"open","locked":false,"title":"Adding list of resource types","user":{"login":"arschles","id":70865,"avatar_url":"https://avatars.githubusercontent.com/u/70865?v=3","gravatar_id":"","url":"https://api.github.com/users/arschles","html_url":"https://github.com/arschles","followers_url":"https://api.github.com/users/arschles/followers","following_url":"https://api.github.com/users/arschles/following{/other_user}","gists_url":"https://api.github.com/users/arschles/gists{/gist_id}","starred_url":"https://api.github.com/users/arschles/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/arschles/subscriptions","organizations_url":"https://api.github.com/users/arschles/orgs","repos_url":"https://api.github.com/users/arschles/repos","events_url":"https://api.github.com/users/arschles/events{/privacy}","received_events_url":"https://api.github.com/users/arschles/received_events","type":"User","site_admin":false},"body":"The types herein will be used in future documents that make progress toward completing https://github.com/kubernetes-incubator/service-catalog/issues/14.\r\n\r\nThis patch partially replaces https://github.com/kubernetes-incubator/service-catalog/pull/13\r\n\r\ncc/ @pmorie @bgrant0607 @duglin @judkowitz @slack @MHBauer \r\n\r\nTODO: \r\n\r\n- [x] put the content herein into a new `api.md` document","created_at":"2016-10-19T21:41:22Z","updated_at":"2016-10-20T21:42:09Z","closed_at":null,"merged_at":null,"merge_commit_sha":"990192ffd3174c0562cd46473bd9dfb33bb29c7e","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/16/commits","review_comments_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/16/comments","review_comment_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/comments{/number}","comments_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues/16/comments","statuses_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/statuses/ad4bd23cc423a024ddf165d597b62858b22bae40","head":{"label":"arschles:nouns","ref":"nouns","sha":"ad4bd23cc423a024ddf165d597b62858b22bae40","user":{"login":"arschles","id":70865,"avatar_url":"https://avatars.githubusercontent.com/u/70865?v=3","gravatar_id":"","url":"https://api.github.com/users/arschles","html_url":"https://github.com/arschles","followers_url":"https://api.github.com/users/arschles/followers","following_url":"https://api.github.com/users/arschles/following{/other_user}","gists_url":"https://api.github.com/users/arschles/gists{/gist_id}","starred_url":"https://api.github.com/users/arschles/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/arschles/subscriptions","organizations_url":"https://api.github.com/users/arschles/orgs","repos_url":"https://api.github.com/users/arschles/repos","events_url":"https://api.github.com/users/arschles/events{/privacy}","received_events_url":"https://api.github.com/users/arschles/received_events","type":"User","site_admin":false},"repo":{"id":70734213,"name":"kubernetes-incubator-service-catalog","full_name":"arschles/kubernetes-incubator-service-catalog","owner":{"login":"arschles","id":70865,"avatar_url":"https://avatars.githubusercontent.com/u/70865?v=3","gravatar_id":"","url":"https://api.github.com/users/arschles","html_url":"https://github.com/arschles","followers_url":"https://api.github.com/users/arschles/followers","following_url":"https://api.github.com/users/arschles/following{/other_user}","gists_url":"https://api.github.com/users/arschles/gists{/gist_id}","starred_url":"https://api.github.com/users/arschles/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/arschles/subscriptions","organizations_url":"https://api.github.com/users/arschles/orgs","repos_url":"https://api.github.com/users/arschles/repos","events_url":"https://api.github.com/users/arschles/events{/privacy}","received_events_url":"https://api.github.com/users/arschles/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/arschles/kubernetes-incubator-service-catalog","description":"Share and consume services in Kubernetes using service brokers","fork":true,"url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog","forks_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/forks","keys_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/keys{/key_id}","collaborators_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/teams","hooks_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/hooks","issue_events_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/issues/events{/number}","events_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/events","assignees_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/assignees{/user}","branches_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/branches{/branch}","tags_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/tags","blobs_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/git/refs{/sha}","trees_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/git/trees{/sha}","statuses_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/statuses/{sha}","languages_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/languages","stargazers_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/stargazers","contributors_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/contributors","subscribers_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/subscribers","subscription_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/subscription","commits_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/commits{/sha}","git_commits_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/git/commits{/sha}","comments_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/comments{/number}","issue_comment_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/issues/comments{/number}","contents_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/contents/{+path}","compare_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/compare/{base}...{head}","merges_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/merges","archive_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/downloads","issues_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/issues{/number}","pulls_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/pulls{/number}","milestones_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/milestones{/number}","notifications_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/labels{/name}","releases_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/releases{/id}","deployments_url":"https://api.github.com/repos/arschles/kubernetes-incubator-service-catalog/deployments","created_at":"2016-10-12T19:28:49Z","updated_at":"2016-10-12T19:29:01Z","pushed_at":"2016-10-19T23:40:09Z","git_url":"git://github.com/arschles/kubernetes-incubator-service-catalog.git","ssh_url":"git@github.com:arschles/kubernetes-incubator-service-catalog.git","clone_url":"https://github.com/arschles/kubernetes-incubator-service-catalog.git","svn_url":"https://github.com/arschles/kubernetes-incubator-service-catalog","homepage":"","size":138,"stargazers_count":0,"watchers_count":0,"language":null,"has_issues":false,"has_downloads":true,"has_wiki":true,"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":"kubernetes-incubator:master","ref":"master","sha":"05c06422bbb19c9ac0d29a9526108a8113237745","user":{"login":"kubernetes-incubator","id":20862812,"avatar_url":"https://avatars.githubusercontent.com/u/20862812?v=3","gravatar_id":"","url":"https://api.github.com/users/kubernetes-incubator","html_url":"https://github.com/kubernetes-incubator","followers_url":"https://api.github.com/users/kubernetes-incubator/followers","following_url":"https://api.github.com/users/kubernetes-incubator/following{/other_user}","gists_url":"https://api.github.com/users/kubernetes-incubator/gists{/gist_id}","starred_url":"https://api.github.com/users/kubernetes-incubator/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kubernetes-incubator/subscriptions","organizations_url":"https://api.github.com/users/kubernetes-incubator/orgs","repos_url":"https://api.github.com/users/kubernetes-incubator/repos","events_url":"https://api.github.com/users/kubernetes-incubator/events{/privacy}","received_events_url":"https://api.github.com/users/kubernetes-incubator/received_events","type":"Organization","site_admin":false},"repo":{"id":68024288,"name":"service-catalog","full_name":"kubernetes-incubator/service-catalog","owner":{"login":"kubernetes-incubator","id":20862812,"avatar_url":"https://avatars.githubusercontent.com/u/20862812?v=3","gravatar_id":"","url":"https://api.github.com/users/kubernetes-incubator","html_url":"https://github.com/kubernetes-incubator","followers_url":"https://api.github.com/users/kubernetes-incubator/followers","following_url":"https://api.github.com/users/kubernetes-incubator/following{/other_user}","gists_url":"https://api.github.com/users/kubernetes-incubator/gists{/gist_id}","starred_url":"https://api.github.com/users/kubernetes-incubator/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kubernetes-incubator/subscriptions","organizations_url":"https://api.github.com/users/kubernetes-incubator/orgs","repos_url":"https://api.github.com/users/kubernetes-incubator/repos","events_url":"https://api.github.com/users/kubernetes-incubator/events{/privacy}","received_events_url":"https://api.github.com/users/kubernetes-incubator/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/kubernetes-incubator/service-catalog","description":"Share and consume services in Kubernetes using service brokers","fork":false,"url":"https://api.github.com/repos/kubernetes-incubator/service-catalog","forks_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/forks","keys_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/keys{/key_id}","collaborators_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/teams","hooks_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/hooks","issue_events_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues/events{/number}","events_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/events","assignees_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/assignees{/user}","branches_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/branches{/branch}","tags_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/tags","blobs_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/git/refs{/sha}","trees_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/git/trees{/sha}","statuses_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/statuses/{sha}","languages_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/languages","stargazers_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/stargazers","contributors_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/contributors","subscribers_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/subscribers","subscription_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/subscription","commits_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/commits{/sha}","git_commits_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/git/commits{/sha}","comments_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/comments{/number}","issue_comment_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues/comments{/number}","contents_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/contents/{+path}","compare_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/compare/{base}...{head}","merges_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/merges","archive_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/downloads","issues_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues{/number}","pulls_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls{/number}","milestones_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/milestones{/number}","notifications_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/labels{/name}","releases_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/releases{/id}","deployments_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/deployments","created_at":"2016-09-12T15:58:39Z","updated_at":"2016-10-10T20:05:07Z","pushed_at":"2016-10-20T03:05:25Z","git_url":"git://github.com/kubernetes-incubator/service-catalog.git","ssh_url":"git@github.com:kubernetes-incubator/service-catalog.git","clone_url":"https://github.com/kubernetes-incubator/service-catalog.git","svn_url":"https://github.com/kubernetes-incubator/service-catalog","homepage":"","size":21,"stargazers_count":10,"watchers_count":10,"language":null,"has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":7,"mirror_url":null,"open_issues_count":5,"forks":7,"open_issues":5,"watchers":10,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/16"},"html":{"href":"https://github.com/kubernetes-incubator/service-catalog/pull/16"},"issue":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues/16"},"comments":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues/16/comments"},"review_comments":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/16/comments"},"review_comment":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/16/commits"},"statuses":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/statuses/ad4bd23cc423a024ddf165d597b62858b22bae40"}}}}
{"actor":{"display_login":"pmorie"}}