{"action":"created","issue":{"url":"https://api.github.com/repos/OData/vocabularies/issues/1","labels_url":"https://api.github.com/repos/OData/vocabularies/issues/1/labels{/name}","comments_url":"https://api.github.com/repos/OData/vocabularies/issues/1/comments","events_url":"https://api.github.com/repos/OData/vocabularies/issues/1/events","html_url":"https://github.com/OData/vocabularies/issues/1","id":64172265,"number":1,"title":"Should version numbers be included in vocabulary namespaces","user":{"login":"markdstafford","id":1216569,"avatar_url":"https://avatars.githubusercontent.com/u/1216569?v=3","gravatar_id":"","url":"https://api.github.com/users/markdstafford","html_url":"https://github.com/markdstafford","followers_url":"https://api.github.com/users/markdstafford/followers","following_url":"https://api.github.com/users/markdstafford/following{/other_user}","gists_url":"https://api.github.com/users/markdstafford/gists{/gist_id}","starred_url":"https://api.github.com/users/markdstafford/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/markdstafford/subscriptions","organizations_url":"https://api.github.com/users/markdstafford/orgs","repos_url":"https://api.github.com/users/markdstafford/repos","events_url":"https://api.github.com/users/markdstafford/events{/privacy}","received_events_url":"https://api.github.com/users/markdstafford/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":6,"created_at":"2015-03-25T04:41:27Z","updated_at":"2015-03-31T04:48:45Z","closed_at":null,"body":"The [OData core vocabulary][1] includes the version number in the vocabulary namespace in addition to the URL. This seems redundant and would require OData services that reference the vocabulary to keep namespace and URL in sync.\r\n\r\nThe proposed convention for community vocabularies stored here would be to include the version in the file name but not the vocabulary namespace.\r\n\r\n[1]: http://docs.oasis-open.org/odata/odata/v4.0/os/vocabularies/Org.OData.Core.V1.xml"},"comment":{"url":"https://api.github.com/repos/OData/vocabularies/issues/comments/87937908","html_url":"https://github.com/OData/vocabularies/issues/1#issuecomment-87937908","issue_url":"https://api.github.com/repos/OData/vocabularies/issues/1","id":87937908,"user":{"login":"markdstafford","id":1216569,"avatar_url":"https://avatars.githubusercontent.com/u/1216569?v=3","gravatar_id":"","url":"https://api.github.com/users/markdstafford","html_url":"https://github.com/markdstafford","followers_url":"https://api.github.com/users/markdstafford/followers","following_url":"https://api.github.com/users/markdstafford/following{/other_user}","gists_url":"https://api.github.com/users/markdstafford/gists{/gist_id}","starred_url":"https://api.github.com/users/markdstafford/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/markdstafford/subscriptions","organizations_url":"https://api.github.com/users/markdstafford/orgs","repos_url":"https://api.github.com/users/markdstafford/repos","events_url":"https://api.github.com/users/markdstafford/events{/privacy}","received_events_url":"https://api.github.com/users/markdstafford/received_events","type":"User","site_admin":false},"created_at":"2015-03-31T04:48:44Z","updated_at":"2015-03-31T04:48:44Z","body":"I'm not sure I buy into the built-in argument but I get your point.\r\n\r\n@dingeins had (IMO) a better point as we discussed the other day that convinced me we need the version number in both places. Consider a REST API that wants to annotate resources with the `Contact` vocabulary. There are three versions of the `Contact` vocabulary and the server has clients that know about all three versions. The REST API would likely annotate resources using all three versions of the vocabulary, which would create a conflict if both the URL and namespace are not versioned.\r\n\r\nI will add a version to Display's namespace."}}