{"action":"created","comment":{"url":"https://api.github.com/repos/opentracing/specification/pulls/comments/175721924","pull_request_review_id":105292800,"id":175721924,"diff_hunk":"@@ -0,0 +1,85 @@\n+# Versioning Process for the OpenTracing Specification\n+The OpenTracing specification consists of a cross-language, abstract interface, along with an attendant set of language-specific interfaces. Every interface is versioned, with each language interface supporting a version of the abstract interface.\n+\n+In order effect changes to the OpenTracing specification, all interfaces are developed together in a three step process:\n+\n+* DRAFT: An RFC is drafted to define and justify the desired changes.\n+* TEST: A new version of each language interface is designed, tested, and released.\n+* ACCEPTED: The abstract interface is versioned to reflect the final changes.\n+\n+# Proposal Components\n+\n+## RFC (Request for Change)\n+Proposals begin as a single document, written in markdown and committed to the `/rfc` directory.\n+\n+An RFC consists of the following:\n+\n+* Proposal name, status, and author.\n+* Problem statement.\n+* Historical background.\n+* Abstract interface.\n+* Use cases.\n+* Risk Assessment.\n+\n+An RFC has the following qualities:\n+\n+* The issue is clearly defined, and within the scope of the OpenTracing charter.\n+* The utility to the OT community is illustrated with concrete use cases. It should be clear not only what will change, but how the new interface is expected to be used.\n+* Changes to the abstract interface are clearly defined. Language-specific interfaces will be implemented in a later phase, but the abstract interface must be clear enough that the changes could be ported to many languages without much deviation.\n+* All expected behavior should be documented, in sufficient detail such that language-specific tests and examples can be generated from the descriptions.\n+* Risks, backwards compatibility, and potential for inconsistency are addressed.\n+\n+## Tracking Issue\n+Often, a proposal will consist of multiple artifacts, such as GitHub issues, pull requests, release candidates, etc. In order to manage these resources, a single, long-running tracking issue is assigned to each proposal.\n+\n+A tracking issue consists of the following:\n+\n+* Proposal name, status, and author.\n+* Short summary or proposal abstract.\n+* A link to the RFC.\n+* Lists of open issues, PRs, and upcoming deadlines.\n+* Links to relevant artifacts, such as release candidates.\n+* Links to meetings and other discussion channels.\n+\n+## Release Candidates\n+Each language interface implements the abstract interface contained in the RFC.\n+\n+A complete release candidate consists of the following:\n+* Repository branch containing the new version.\n+* Packages for installing the new version.\n+* Tracers which bind to the new version.\n+* Major instrumentation ported to the new version.\n+\n+# Proposal Lifecycle\n+\n+## Draft\n+* Pull request to add the draft RFC to `/rfc`. \n+* Tracking issue for the proposal is opened.\n+* Debate continues via pull requests against the draft.\n+\n+A draft proposal is first submitted as a pull request against the specification repository. \n+\n+Once there is consensus that the pull request meets the minimum criteria for the beginnings of a draft, and has strong potential to be accepted, the pull request is merged. A tracking issue is created at this point to manage the proposal. The draft RFC is then refined via more pull requests.\n+\n+Consensus is used to determine that all of the abstract proposal work has been completed, and the investigation should move to language implementations.\n+\n+## Test\n+* RFC status changed from `Draft` to `Test`.\n+* Release Candidate per major language is created.","path":"rfc_process.md","position":68,"original_position":68,"commit_id":"dff3ea4691459e4fd69ef2ad692e3cf5beaae18c","original_commit_id":"dff3ea4691459e4fd69ef2ad692e3cf5beaae18c","user":{"login":"jpkrohling","id":13387,"avatar_url":"https://avatars2.githubusercontent.com/u/13387?v=4","gravatar_id":"","url":"https://api.github.com/users/jpkrohling","html_url":"https://github.com/jpkrohling","followers_url":"https://api.github.com/users/jpkrohling/followers","following_url":"https://api.github.com/users/jpkrohling/following{/other_user}","gists_url":"https://api.github.com/users/jpkrohling/gists{/gist_id}","starred_url":"https://api.github.com/users/jpkrohling/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jpkrohling/subscriptions","organizations_url":"https://api.github.com/users/jpkrohling/orgs","repos_url":"https://api.github.com/users/jpkrohling/repos","events_url":"https://api.github.com/users/jpkrohling/events{/privacy}","received_events_url":"https://api.github.com/users/jpkrohling/received_events","type":"User","site_admin":false},"body":"Do we have a list of \"major languages\" defined somewhere?","created_at":"2018-03-20T10:47:32Z","updated_at":"2018-03-20T10:48:26Z","html_url":"https://github.com/opentracing/specification/pull/106#discussion_r175721924","pull_request_url":"https://api.github.com/repos/opentracing/specification/pulls/106","author_association":"NONE","_links":{"self":{"href":"https://api.github.com/repos/opentracing/specification/pulls/comments/175721924"},"html":{"href":"https://github.com/opentracing/specification/pull/106#discussion_r175721924"},"pull_request":{"href":"https://api.github.com/repos/opentracing/specification/pulls/106"}}},"pull_request":{"url":"https://api.github.com/repos/opentracing/specification/pulls/106","id":172041898,"html_url":"https://github.com/opentracing/specification/pull/106","diff_url":"https://github.com/opentracing/specification/pull/106.diff","patch_url":"https://github.com/opentracing/specification/pull/106.patch","issue_url":"https://api.github.com/repos/opentracing/specification/issues/106","number":106,"state":"open","locked":false,"title":"Versioning process for the OpenTracing specification","user":{"login":"tedsuo","id":24074,"avatar_url":"https://avatars2.githubusercontent.com/u/24074?v=4","gravatar_id":"","url":"https://api.github.com/users/tedsuo","html_url":"https://github.com/tedsuo","followers_url":"https://api.github.com/users/tedsuo/followers","following_url":"https://api.github.com/users/tedsuo/following{/other_user}","gists_url":"https://api.github.com/users/tedsuo/gists{/gist_id}","starred_url":"https://api.github.com/users/tedsuo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tedsuo/subscriptions","organizations_url":"https://api.github.com/users/tedsuo/orgs","repos_url":"https://api.github.com/users/tedsuo/repos","events_url":"https://api.github.com/users/tedsuo/events{/privacy}","received_events_url":"https://api.github.com/users/tedsuo/received_events","type":"User","site_admin":false},"body":"## RFC Proposal\r\nhttps://github.com/opentracing/specification/blob/tedsuo/rfc-process/rfc_process.md\r\nDefines a more formal versioning process for the OpenTracing specification.\r\n\r\n## RFC Template\r\nhttps://github.com/opentracing/specification/blob/tedsuo/rfc-process/rfc_template.md\r\nTo be used for starting proposals.\r\n\r\n## Example RFC\r\nhttps://github.com/opentracing/specification/pull/107 [Trace-Parent Accessors](https://github.com/opentracing/specification/pull/107)\r\nA real change request, done in the format defined within this pull request.\r\n\r\n## Inspiration and prior art\r\n* Couchbase: https://github.com/couchbaselabs/sdk-rfcs/\r\n* IETF\r\n* W3C\r\n","created_at":"2018-02-28T18:58:54Z","updated_at":"2018-03-20T10:48:26Z","closed_at":null,"merged_at":null,"merge_commit_sha":"d2185cfc116d2b511626603b1e9805dd84f9e6e7","assignee":null,"assignees":[],"requested_reviewers":[{"login":"pavolloffay","id":5618424,"avatar_url":"https://avatars0.githubusercontent.com/u/5618424?v=4","gravatar_id":"","url":"https://api.github.com/users/pavolloffay","html_url":"https://github.com/pavolloffay","followers_url":"https://api.github.com/users/pavolloffay/followers","following_url":"https://api.github.com/users/pavolloffay/following{/other_user}","gists_url":"https://api.github.com/users/pavolloffay/gists{/gist_id}","starred_url":"https://api.github.com/users/pavolloffay/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pavolloffay/subscriptions","organizations_url":"https://api.github.com/users/pavolloffay/orgs","repos_url":"https://api.github.com/users/pavolloffay/repos","events_url":"https://api.github.com/users/pavolloffay/events{/privacy}","received_events_url":"https://api.github.com/users/pavolloffay/received_events","type":"User","site_admin":false}],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/opentracing/specification/pulls/106/commits","review_comments_url":"https://api.github.com/repos/opentracing/specification/pulls/106/comments","review_comment_url":"https://api.github.com/repos/opentracing/specification/pulls/comments{/number}","comments_url":"https://api.github.com/repos/opentracing/specification/issues/106/comments","statuses_url":"https://api.github.com/repos/opentracing/specification/statuses/dff3ea4691459e4fd69ef2ad692e3cf5beaae18c","head":{"label":"opentracing:tedsuo/rfc-process","ref":"tedsuo/rfc-process","sha":"dff3ea4691459e4fd69ef2ad692e3cf5beaae18c","user":{"login":"opentracing","id":15482765,"avatar_url":"https://avatars1.githubusercontent.com/u/15482765?v=4","gravatar_id":"","url":"https://api.github.com/users/opentracing","html_url":"https://github.com/opentracing","followers_url":"https://api.github.com/users/opentracing/followers","following_url":"https://api.github.com/users/opentracing/following{/other_user}","gists_url":"https://api.github.com/users/opentracing/gists{/gist_id}","starred_url":"https://api.github.com/users/opentracing/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/opentracing/subscriptions","organizations_url":"https://api.github.com/users/opentracing/orgs","repos_url":"https://api.github.com/users/opentracing/repos","events_url":"https://api.github.com/users/opentracing/events{/privacy}","received_events_url":"https://api.github.com/users/opentracing/received_events","type":"Organization","site_admin":false},"repo":{"id":73649995,"name":"specification","full_name":"opentracing/specification","owner":{"login":"opentracing","id":15482765,"avatar_url":"https://avatars1.githubusercontent.com/u/15482765?v=4","gravatar_id":"","url":"https://api.github.com/users/opentracing","html_url":"https://github.com/opentracing","followers_url":"https://api.github.com/users/opentracing/followers","following_url":"https://api.github.com/users/opentracing/following{/other_user}","gists_url":"https://api.github.com/users/opentracing/gists{/gist_id}","starred_url":"https://api.github.com/users/opentracing/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/opentracing/subscriptions","organizations_url":"https://api.github.com/users/opentracing/orgs","repos_url":"https://api.github.com/users/opentracing/repos","events_url":"https://api.github.com/users/opentracing/events{/privacy}","received_events_url":"https://api.github.com/users/opentracing/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/opentracing/specification","description":"A place to document (and discuss) the OpenTracing specification","fork":false,"url":"https://api.github.com/repos/opentracing/specification","forks_url":"https://api.github.com/repos/opentracing/specification/forks","keys_url":"https://api.github.com/repos/opentracing/specification/keys{/key_id}","collaborators_url":"https://api.github.com/repos/opentracing/specification/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/opentracing/specification/teams","hooks_url":"https://api.github.com/repos/opentracing/specification/hooks","issue_events_url":"https://api.github.com/repos/opentracing/specification/issues/events{/number}","events_url":"https://api.github.com/repos/opentracing/specification/events","assignees_url":"https://api.github.com/repos/opentracing/specification/assignees{/user}","branches_url":"https://api.github.com/repos/opentracing/specification/branches{/branch}","tags_url":"https://api.github.com/repos/opentracing/specification/tags","blobs_url":"https://api.github.com/repos/opentracing/specification/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/opentracing/specification/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/opentracing/specification/git/refs{/sha}","trees_url":"https://api.github.com/repos/opentracing/specification/git/trees{/sha}","statuses_url":"https://api.github.com/repos/opentracing/specification/statuses/{sha}","languages_url":"https://api.github.com/repos/opentracing/specification/languages","stargazers_url":"https://api.github.com/repos/opentracing/specification/stargazers","contributors_url":"https://api.github.com/repos/opentracing/specification/contributors","subscribers_url":"https://api.github.com/repos/opentracing/specification/subscribers","subscription_url":"https://api.github.com/repos/opentracing/specification/subscription","commits_url":"https://api.github.com/repos/opentracing/specification/commits{/sha}","git_commits_url":"https://api.github.com/repos/opentracing/specification/git/commits{/sha}","comments_url":"https://api.github.com/repos/opentracing/specification/comments{/number}","issue_comment_url":"https://api.github.com/repos/opentracing/specification/issues/comments{/number}","contents_url":"https://api.github.com/repos/opentracing/specification/contents/{+path}","compare_url":"https://api.github.com/repos/opentracing/specification/compare/{base}...{head}","merges_url":"https://api.github.com/repos/opentracing/specification/merges","archive_url":"https://api.github.com/repos/opentracing/specification/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/opentracing/specification/downloads","issues_url":"https://api.github.com/repos/opentracing/specification/issues{/number}","pulls_url":"https://api.github.com/repos/opentracing/specification/pulls{/number}","milestones_url":"https://api.github.com/repos/opentracing/specification/milestones{/number}","notifications_url":"https://api.github.com/repos/opentracing/specification/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/opentracing/specification/labels{/name}","releases_url":"https://api.github.com/repos/opentracing/specification/releases{/id}","deployments_url":"https://api.github.com/repos/opentracing/specification/deployments","created_at":"2016-11-13T23:32:39Z","updated_at":"2018-03-20T07:58:09Z","pushed_at":"2018-03-19T17:40:55Z","git_url":"git://github.com/opentracing/specification.git","ssh_url":"git@github.com:opentracing/specification.git","clone_url":"https://github.com/opentracing/specification.git","svn_url":"https://github.com/opentracing/specification","homepage":"http://opentracing.io/spec","size":87,"stargazers_count":290,"watchers_count":290,"language":null,"has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":49,"mirror_url":null,"archived":false,"open_issues_count":59,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0"},"forks":49,"open_issues":59,"watchers":290,"default_branch":"master"}},"base":{"label":"opentracing:master","ref":"master","sha":"1995fb9e8c9da677549e71fda4b94b5fb488531d","user":{"login":"opentracing","id":15482765,"avatar_url":"https://avatars1.githubusercontent.com/u/15482765?v=4","gravatar_id":"","url":"https://api.github.com/users/opentracing","html_url":"https://github.com/opentracing","followers_url":"https://api.github.com/users/opentracing/followers","following_url":"https://api.github.com/users/opentracing/following{/other_user}","gists_url":"https://api.github.com/users/opentracing/gists{/gist_id}","starred_url":"https://api.github.com/users/opentracing/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/opentracing/subscriptions","organizations_url":"https://api.github.com/users/opentracing/orgs","repos_url":"https://api.github.com/users/opentracing/repos","events_url":"https://api.github.com/users/opentracing/events{/privacy}","received_events_url":"https://api.github.com/users/opentracing/received_events","type":"Organization","site_admin":false},"repo":{"id":73649995,"name":"specification","full_name":"opentracing/specification","owner":{"login":"opentracing","id":15482765,"avatar_url":"https://avatars1.githubusercontent.com/u/15482765?v=4","gravatar_id":"","url":"https://api.github.com/users/opentracing","html_url":"https://github.com/opentracing","followers_url":"https://api.github.com/users/opentracing/followers","following_url":"https://api.github.com/users/opentracing/following{/other_user}","gists_url":"https://api.github.com/users/opentracing/gists{/gist_id}","starred_url":"https://api.github.com/users/opentracing/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/opentracing/subscriptions","organizations_url":"https://api.github.com/users/opentracing/orgs","repos_url":"https://api.github.com/users/opentracing/repos","events_url":"https://api.github.com/users/opentracing/events{/privacy}","received_events_url":"https://api.github.com/users/opentracing/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/opentracing/specification","description":"A place to document (and discuss) the OpenTracing specification","fork":false,"url":"https://api.github.com/repos/opentracing/specification","forks_url":"https://api.github.com/repos/opentracing/specification/forks","keys_url":"https://api.github.com/repos/opentracing/specification/keys{/key_id}","collaborators_url":"https://api.github.com/repos/opentracing/specification/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/opentracing/specification/teams","hooks_url":"https://api.github.com/repos/opentracing/specification/hooks","issue_events_url":"https://api.github.com/repos/opentracing/specification/issues/events{/number}","events_url":"https://api.github.com/repos/opentracing/specification/events","assignees_url":"https://api.github.com/repos/opentracing/specification/assignees{/user}","branches_url":"https://api.github.com/repos/opentracing/specification/branches{/branch}","tags_url":"https://api.github.com/repos/opentracing/specification/tags","blobs_url":"https://api.github.com/repos/opentracing/specification/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/opentracing/specification/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/opentracing/specification/git/refs{/sha}","trees_url":"https://api.github.com/repos/opentracing/specification/git/trees{/sha}","statuses_url":"https://api.github.com/repos/opentracing/specification/statuses/{sha}","languages_url":"https://api.github.com/repos/opentracing/specification/languages","stargazers_url":"https://api.github.com/repos/opentracing/specification/stargazers","contributors_url":"https://api.github.com/repos/opentracing/specification/contributors","subscribers_url":"https://api.github.com/repos/opentracing/specification/subscribers","subscription_url":"https://api.github.com/repos/opentracing/specification/subscription","commits_url":"https://api.github.com/repos/opentracing/specification/commits{/sha}","git_commits_url":"https://api.github.com/repos/opentracing/specification/git/commits{/sha}","comments_url":"https://api.github.com/repos/opentracing/specification/comments{/number}","issue_comment_url":"https://api.github.com/repos/opentracing/specification/issues/comments{/number}","contents_url":"https://api.github.com/repos/opentracing/specification/contents/{+path}","compare_url":"https://api.github.com/repos/opentracing/specification/compare/{base}...{head}","merges_url":"https://api.github.com/repos/opentracing/specification/merges","archive_url":"https://api.github.com/repos/opentracing/specification/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/opentracing/specification/downloads","issues_url":"https://api.github.com/repos/opentracing/specification/issues{/number}","pulls_url":"https://api.github.com/repos/opentracing/specification/pulls{/number}","milestones_url":"https://api.github.com/repos/opentracing/specification/milestones{/number}","notifications_url":"https://api.github.com/repos/opentracing/specification/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/opentracing/specification/labels{/name}","releases_url":"https://api.github.com/repos/opentracing/specification/releases{/id}","deployments_url":"https://api.github.com/repos/opentracing/specification/deployments","created_at":"2016-11-13T23:32:39Z","updated_at":"2018-03-20T07:58:09Z","pushed_at":"2018-03-19T17:40:55Z","git_url":"git://github.com/opentracing/specification.git","ssh_url":"git@github.com:opentracing/specification.git","clone_url":"https://github.com/opentracing/specification.git","svn_url":"https://github.com/opentracing/specification","homepage":"http://opentracing.io/spec","size":87,"stargazers_count":290,"watchers_count":290,"language":null,"has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":49,"mirror_url":null,"archived":false,"open_issues_count":59,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0"},"forks":49,"open_issues":59,"watchers":290,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/opentracing/specification/pulls/106"},"html":{"href":"https://github.com/opentracing/specification/pull/106"},"issue":{"href":"https://api.github.com/repos/opentracing/specification/issues/106"},"comments":{"href":"https://api.github.com/repos/opentracing/specification/issues/106/comments"},"review_comments":{"href":"https://api.github.com/repos/opentracing/specification/pulls/106/comments"},"review_comment":{"href":"https://api.github.com/repos/opentracing/specification/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/opentracing/specification/pulls/106/commits"},"statuses":{"href":"https://api.github.com/repos/opentracing/specification/statuses/dff3ea4691459e4fd69ef2ad692e3cf5beaae18c"}},"author_association":"OWNER"}}
{"actor":{"display_login":"jpkrohling"}}