{"action":"created","issue":{"url":"https://api.github.com/repos/opentracing/specification/issues/63","repository_url":"https://api.github.com/repos/opentracing/specification","labels_url":"https://api.github.com/repos/opentracing/specification/issues/63/labels{/name}","comments_url":"https://api.github.com/repos/opentracing/specification/issues/63/comments","events_url":"https://api.github.com/repos/opentracing/specification/issues/63/events","html_url":"https://github.com/opentracing/specification/issues/63","id":218717121,"number":63,"title":"Define incubation process for proposed specification changes","user":{"login":"yurishkuro","id":3523016,"avatar_url":"https://avatars1.githubusercontent.com/u/3523016?v=3","gravatar_id":"","url":"https://api.github.com/users/yurishkuro","html_url":"https://github.com/yurishkuro","followers_url":"https://api.github.com/users/yurishkuro/followers","following_url":"https://api.github.com/users/yurishkuro/following{/other_user}","gists_url":"https://api.github.com/users/yurishkuro/gists{/gist_id}","starred_url":"https://api.github.com/users/yurishkuro/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/yurishkuro/subscriptions","organizations_url":"https://api.github.com/users/yurishkuro/orgs","repos_url":"https://api.github.com/users/yurishkuro/repos","events_url":"https://api.github.com/users/yurishkuro/events{/privacy}","received_events_url":"https://api.github.com/users/yurishkuro/received_events","type":"User","site_admin":false},"labels":[{"id":480879229,"url":"https://api.github.com/repos/opentracing/specification/labels/enhancement","name":"enhancement","color":"84b6eb","default":true}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":1,"created_at":"2017-04-01T19:20:54Z","updated_at":"2017-04-02T21:03:15Z","closed_at":null,"body":"In the last OTSC meeting ([2017/03/24](https://docs.google.com/document/d/1Pc86BVWVGnldsdAtwDQLfMWEpO4ni4IHm0xaNQvnScI/edit#heading=h.4ryddc6fty5m)) we discussed that it would be good to define a process for incubating new features being suggested for the specification, such as #57. It should probably be defined in the [project_organization.md](https://github.com/opentracing/specification/blob/master/project_organization.md) document.\r\n\r\nSome of the guidelines that come to mind:\r\n  * languages like Java that support method overloading are very suitable for defining the proposed extension as an optional interface in `opentracing-contrib` that can be implemented by the tracers to allow the extended functionality (e.g. #62)\r\n  * the incubating project can provide a downgrade wrapper for tracers that do not support the new functionality. For example, #62 suggests adding a new \"log level\" argument to the log methods. It can provide a wrapper that implements the new extension methods by delegating to the official API in some way, e.g. by moving the log level from an argument to a tag.\r\n  * if it 's demonstrated that at least three existing OT implementations support the incubating specification change it can be considered for becoming a part of the official API"},"comment":{"url":"https://api.github.com/repos/opentracing/specification/issues/comments/291014938","html_url":"https://github.com/opentracing/specification/issues/63#issuecomment-291014938","issue_url":"https://api.github.com/repos/opentracing/specification/issues/63","id":291014938,"user":{"login":"bhs","id":2251553,"avatar_url":"https://avatars1.githubusercontent.com/u/2251553?v=3","gravatar_id":"","url":"https://api.github.com/users/bhs","html_url":"https://github.com/bhs","followers_url":"https://api.github.com/users/bhs/followers","following_url":"https://api.github.com/users/bhs/following{/other_user}","gists_url":"https://api.github.com/users/bhs/gists{/gist_id}","starred_url":"https://api.github.com/users/bhs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bhs/subscriptions","organizations_url":"https://api.github.com/users/bhs/orgs","repos_url":"https://api.github.com/users/bhs/repos","events_url":"https://api.github.com/users/bhs/events{/privacy}","received_events_url":"https://api.github.com/users/bhs/received_events","type":"User","site_admin":false},"created_at":"2017-04-02T21:03:15Z","updated_at":"2017-04-02T21:03:15Z","body":"@yurishkuro demonstrated support from three impls seems sufficient, though I wonder if it's \"necessary\" in many cases. So much of this depends on the complexity and impact of the proposed change, and unfortunately that's more than just API-breaking-ness. E.g., the log verbosity thing is really just agreement about the comments for a string constant, yet it's controversial and will probably remain that way.\r\n\r\nAnother idea would be to require a sort of 1-pager summarizing \"significant\" (definition of _significant_ left as an \"exercise to the reader\"!) changes, possible benefits for tracing systems, possible risks, and alternatives. Essentially a concise design doc; maybe just an issue template, I don't know. Anyway, if those proposals are uncontroversial as far as the OTSC is concerned, then great. And otherwise, we could just take things case-by-case."}}
{"actor":{"display_login":"bhs"}}