{"action":"created","issue":{"url":"https://api.github.com/repos/open-contracting/standard/issues/367","repository_url":"https://api.github.com/repos/open-contracting/standard","labels_url":"https://api.github.com/repos/open-contracting/standard/issues/367/labels{/name}","comments_url":"https://api.github.com/repos/open-contracting/standard/issues/367/comments","events_url":"https://api.github.com/repos/open-contracting/standard/issues/367/events","html_url":"https://github.com/open-contracting/standard/issues/367","id":176709338,"number":367,"title":"Deprecation policy","user":{"login":"timgdavies","id":342624,"avatar_url":"https://avatars.githubusercontent.com/u/342624?v=3","gravatar_id":"","url":"https://api.github.com/users/timgdavies","html_url":"https://github.com/timgdavies","followers_url":"https://api.github.com/users/timgdavies/followers","following_url":"https://api.github.com/users/timgdavies/following{/other_user}","gists_url":"https://api.github.com/users/timgdavies/gists{/gist_id}","starred_url":"https://api.github.com/users/timgdavies/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/timgdavies/subscriptions","organizations_url":"https://api.github.com/users/timgdavies/orgs","repos_url":"https://api.github.com/users/timgdavies/repos","events_url":"https://api.github.com/users/timgdavies/events{/privacy}","received_events_url":"https://api.github.com/users/timgdavies/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/open-contracting/standard/labels/2%20-%20Proposal","name":"2 - Proposal","color":"fbca04"}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":{"url":"https://api.github.com/repos/open-contracting/standard/milestones/5","html_url":"https://github.com/open-contracting/standard/milestones/Version%201.1","labels_url":"https://api.github.com/repos/open-contracting/standard/milestones/5/labels","id":1231433,"number":5,"title":"Version 1.1","description":"Issues for consideration for Version 1.1","creator":{"login":"timgdavies","id":342624,"avatar_url":"https://avatars.githubusercontent.com/u/342624?v=3","gravatar_id":"","url":"https://api.github.com/users/timgdavies","html_url":"https://github.com/timgdavies","followers_url":"https://api.github.com/users/timgdavies/followers","following_url":"https://api.github.com/users/timgdavies/following{/other_user}","gists_url":"https://api.github.com/users/timgdavies/gists{/gist_id}","starred_url":"https://api.github.com/users/timgdavies/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/timgdavies/subscriptions","organizations_url":"https://api.github.com/users/timgdavies/orgs","repos_url":"https://api.github.com/users/timgdavies/repos","events_url":"https://api.github.com/users/timgdavies/events{/privacy}","received_events_url":"https://api.github.com/users/timgdavies/received_events","type":"User","site_admin":false},"open_issues":82,"closed_issues":23,"state":"open","created_at":"2015-07-29T12:19:44Z","updated_at":"2016-09-17T17:56:47Z","due_on":"2016-09-29T23:00:00Z","closed_at":null},"comments":2,"created_at":"2016-09-13T18:04:52Z","updated_at":"2016-09-17T17:58:14Z","closed_at":null,"body":"This issue is under consideration for the 1.1 milestone. \r\n\r\nBuilding on discussions in #189\r\n\r\n### The issue\r\n\r\nOur deprecation policy currently states (emphasis added) \r\n\r\n> “If a term (a class or field) is scheduled to be renamed or removed from the specification as a result of the revision process, **the next major release** of the specification must deprecate the term within the schema, and **the following major** release must rename or remove the term from the schema, making the term obsolete. Implementations may use deprecated terms, but will receive warnings from the OCDS validator described below. Implementations may not use obsolete terms, and will receive errors from the OCDS validator.”\r\n\r\nThis means we can currently only deprecate fields in version 2.0, and remove them in 3.0.\r\n\r\n### What we are proposing:\r\n\r\nUpdating the deprecation policy to replace the first mention of major release with minor release. \r\n\r\nThis will allow a minor/decimal update (e.g. 1.1) to deprecate a term, triggering validation warnings.\r\n\r\nAn integer/major version update would still be required to remove the term entirely, triggering validation errors if it was still included.\r\n\r\nThis is in line with the guidance in the [Semantic Versioning](http://semver.org/) document.\r\n\r\n### Engagement\r\n\r\nPlease indicate support or opposition for this proposal using the +1 / -1 buttons or a comment. If opposing the proposal, please give clear justifications, and where possible, make an alternative proposals. \r\n"},"comment":{"url":"https://api.github.com/repos/open-contracting/standard/issues/comments/247793962","html_url":"https://github.com/open-contracting/standard/issues/367#issuecomment-247793962","issue_url":"https://api.github.com/repos/open-contracting/standard/issues/367","id":247793962,"user":{"login":"timgdavies","id":342624,"avatar_url":"https://avatars.githubusercontent.com/u/342624?v=3","gravatar_id":"","url":"https://api.github.com/users/timgdavies","html_url":"https://github.com/timgdavies","followers_url":"https://api.github.com/users/timgdavies/followers","following_url":"https://api.github.com/users/timgdavies/following{/other_user}","gists_url":"https://api.github.com/users/timgdavies/gists{/gist_id}","starred_url":"https://api.github.com/users/timgdavies/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/timgdavies/subscriptions","organizations_url":"https://api.github.com/users/timgdavies/orgs","repos_url":"https://api.github.com/users/timgdavies/repos","events_url":"https://api.github.com/users/timgdavies/events{/privacy}","received_events_url":"https://api.github.com/users/timgdavies/received_events","type":"User","site_admin":false},"created_at":"2016-09-17T17:58:14Z","updated_at":"2016-09-17T17:58:14Z","body":"Thanks @dc-coder. \r\n\r\nWe will definitely need to have clear communication for any deprecations.\r\n\r\nWe will work to make the validator handle versioning. I've just updated #301 with the proposals around this. "}}
{"actor":{"display_login":"timgdavies"}}