{"action":"created","comment":{"url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/comments/92011289","pull_request_review_id":12520591,"id":92011289,"diff_hunk":"@@ -0,0 +1,66 @@\n+# Terminology\n+\n+The terminology of service-catalog has some inconvenient and entirely\n+unavoidable overloading with certain terms in the\n+[Kubernetes](https://github.com/kubernetes/kubernetes) lexicon.  This page lists\n+the definitions of terms as used in this project.\n+\n+## Roles\n+\n+**Service Consumer**: Any person or application that will use a Service from\n+the catalog.\n+\n+**Application operator**: The person or team responsible for deploying an\n+application. Users in this role, at minimum, have access to their own\n+application's namespace. In some cases, users in this role may also be an\n+application developer or a cluster operator\n+\n+**Cluster operator**: The person or team responsible for operating a Kubernetes\n+cluster. This team may operate the cluster on behalf of other users, or may\n+operate the cluster to facilitate their own work\n+\n+**Catalog operator**: The person or team responsible for adminstration of the\n+Service Catalog, including catalog curation and Service Broker registration\n+\n+**Broker operator**: The person or team responsible for running and managing one\n+or more **Service Brokers**.\n+\n+**Service Producer**: The person or team who authors and/or operates a Service\n+available from the Service Catalog. As part of creating a service, the Service\n+Producer may also be running a Service Broker.\n+\n+## Lexicon\n+\n+**Service**: Running code that is made available for use by an application.\n+Traditionally, services are available via HTTP REST endpoints, but this is not a\n+requirement.\n+\n+**Service Broker**: An endpoint that manages a set of services. Responsible for\n+translating Service Catalog activities (like provision, bind, unbind,\n+deprovision) into appropriate actions for the service.\n+\n+**Service Catalog**: An endpoint that manages (1) a set of registered Service\n+Brokers and (2) the list of services that are available for instantiation from\n+those Service Brokers.\n+\n+**Service Instance**: Each request for a unique use of a Service will result in\n+the Service Catalog requesting a new Service Instance from the owning Service\n+Broker.\n+\n+**Application**: Code that will access or consume a Service. While in Kubernetes\n+the code that is deployed is often called a \"Service\", to avoid confusion, this\n+document will refer to the code that accesses a service as an \"application\".\n+\n+**Resource type**: A logical Kubernetes concept. Examples include:\n+\n+  - [Pod](http://kubernetes.io/docs/user-guide/pods/)s\n+  - [Service](http://kubernetes.io/docs/user-guide/services/)s\n+  - [Secret](http://kubernetes.io/docs/user-guide/secrets/)s","path":"terminology.md","position":58,"original_position":58,"commit_id":"cbc9c84bb87e1545e023e6b5b596ccb49e05e25c","original_commit_id":"cbc9c84bb87e1545e023e6b5b596ccb49e05e25c","user":{"login":"MHBauer","id":13337345,"avatar_url":"https://avatars.githubusercontent.com/u/13337345?v=3","gravatar_id":"","url":"https://api.github.com/users/MHBauer","html_url":"https://github.com/MHBauer","followers_url":"https://api.github.com/users/MHBauer/followers","following_url":"https://api.github.com/users/MHBauer/following{/other_user}","gists_url":"https://api.github.com/users/MHBauer/gists{/gist_id}","starred_url":"https://api.github.com/users/MHBauer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/MHBauer/subscriptions","organizations_url":"https://api.github.com/users/MHBauer/orgs","repos_url":"https://api.github.com/users/MHBauer/repos","events_url":"https://api.github.com/users/MHBauer/events{/privacy}","received_events_url":"https://api.github.com/users/MHBauer/received_events","type":"User","site_admin":false},"body":"is there any particular reason to not have the s?\r\n\r\nit's weird looking.","created_at":"2016-12-12T18:43:22Z","updated_at":"2016-12-12T18:43:22Z","html_url":"https://github.com/kubernetes-incubator/service-catalog/pull/152#discussion_r92011289","pull_request_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/152","_links":{"self":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/comments/92011289"},"html":{"href":"https://github.com/kubernetes-incubator/service-catalog/pull/152#discussion_r92011289"},"pull_request":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/152"}}},"pull_request":{"url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/152","id":97600582,"html_url":"https://github.com/kubernetes-incubator/service-catalog/pull/152","diff_url":"https://github.com/kubernetes-incubator/service-catalog/pull/152.diff","patch_url":"https://github.com/kubernetes-incubator/service-catalog/pull/152.patch","issue_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues/152","number":152,"state":"open","locked":false,"title":"Make some edits to README.md","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":"Make a couple cleanups to README.md to:\r\n\r\n1.  Communicate the mission without getting bogged down in terminology\r\n2.  Add code of conduct (important!)","created_at":"2016-12-12T17:49:08Z","updated_at":"2016-12-12T18:43:22Z","closed_at":null,"merged_at":null,"merge_commit_sha":"df734271e776e284e8fdf869262921087154fcd7","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/152/commits","review_comments_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/152/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/152/comments","statuses_url":"https://api.github.com/repos/kubernetes-incubator/service-catalog/statuses/cbc9c84bb87e1545e023e6b5b596ccb49e05e25c","head":{"label":"pmorie:docs-massage","ref":"docs-massage","sha":"cbc9c84bb87e1545e023e6b5b596ccb49e05e25c","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},"repo":{"id":68024369,"name":"service-catalog","full_name":"pmorie/service-catalog","owner":{"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},"private":false,"html_url":"https://github.com/pmorie/service-catalog","description":null,"fork":true,"url":"https://api.github.com/repos/pmorie/service-catalog","forks_url":"https://api.github.com/repos/pmorie/service-catalog/forks","keys_url":"https://api.github.com/repos/pmorie/service-catalog/keys{/key_id}","collaborators_url":"https://api.github.com/repos/pmorie/service-catalog/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/pmorie/service-catalog/teams","hooks_url":"https://api.github.com/repos/pmorie/service-catalog/hooks","issue_events_url":"https://api.github.com/repos/pmorie/service-catalog/issues/events{/number}","events_url":"https://api.github.com/repos/pmorie/service-catalog/events","assignees_url":"https://api.github.com/repos/pmorie/service-catalog/assignees{/user}","branches_url":"https://api.github.com/repos/pmorie/service-catalog/branches{/branch}","tags_url":"https://api.github.com/repos/pmorie/service-catalog/tags","blobs_url":"https://api.github.com/repos/pmorie/service-catalog/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/pmorie/service-catalog/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/pmorie/service-catalog/git/refs{/sha}","trees_url":"https://api.github.com/repos/pmorie/service-catalog/git/trees{/sha}","statuses_url":"https://api.github.com/repos/pmorie/service-catalog/statuses/{sha}","languages_url":"https://api.github.com/repos/pmorie/service-catalog/languages","stargazers_url":"https://api.github.com/repos/pmorie/service-catalog/stargazers","contributors_url":"https://api.github.com/repos/pmorie/service-catalog/contributors","subscribers_url":"https://api.github.com/repos/pmorie/service-catalog/subscribers","subscription_url":"https://api.github.com/repos/pmorie/service-catalog/subscription","commits_url":"https://api.github.com/repos/pmorie/service-catalog/commits{/sha}","git_commits_url":"https://api.github.com/repos/pmorie/service-catalog/git/commits{/sha}","comments_url":"https://api.github.com/repos/pmorie/service-catalog/comments{/number}","issue_comment_url":"https://api.github.com/repos/pmorie/service-catalog/issues/comments{/number}","contents_url":"https://api.github.com/repos/pmorie/service-catalog/contents/{+path}","compare_url":"https://api.github.com/repos/pmorie/service-catalog/compare/{base}...{head}","merges_url":"https://api.github.com/repos/pmorie/service-catalog/merges","archive_url":"https://api.github.com/repos/pmorie/service-catalog/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/pmorie/service-catalog/downloads","issues_url":"https://api.github.com/repos/pmorie/service-catalog/issues{/number}","pulls_url":"https://api.github.com/repos/pmorie/service-catalog/pulls{/number}","milestones_url":"https://api.github.com/repos/pmorie/service-catalog/milestones{/number}","notifications_url":"https://api.github.com/repos/pmorie/service-catalog/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/pmorie/service-catalog/labels{/name}","releases_url":"https://api.github.com/repos/pmorie/service-catalog/releases{/id}","deployments_url":"https://api.github.com/repos/pmorie/service-catalog/deployments","created_at":"2016-09-12T15:59:41Z","updated_at":"2016-12-01T00:14:18Z","pushed_at":"2016-12-12T17:31:25Z","git_url":"git://github.com/pmorie/service-catalog.git","ssh_url":"git@github.com:pmorie/service-catalog.git","clone_url":"https://github.com/pmorie/service-catalog.git","svn_url":"https://github.com/pmorie/service-catalog","homepage":null,"size":39511,"stargazers_count":0,"watchers_count":0,"language":"Go","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":"e2a5b6850f506d41aac9b763c511870c76ac15bd","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-12-12T02:58:10Z","pushed_at":"2016-12-12T17:56:24Z","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":39732,"stargazers_count":29,"watchers_count":29,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":22,"mirror_url":null,"open_issues_count":41,"forks":22,"open_issues":41,"watchers":29,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/152"},"html":{"href":"https://github.com/kubernetes-incubator/service-catalog/pull/152"},"issue":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues/152"},"comments":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/issues/152/comments"},"review_comments":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/pulls/152/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/152/commits"},"statuses":{"href":"https://api.github.com/repos/kubernetes-incubator/service-catalog/statuses/cbc9c84bb87e1545e023e6b5b596ccb49e05e25c"}}}}
{"actor":{"display_login":"MHBauer"}}