{"action":"created","issue":{"url":"https://api.github.com/repos/Vela/Guides/issues/9","labels_url":"https://api.github.com/repos/Vela/Guides/issues/9/labels{/name}","comments_url":"https://api.github.com/repos/Vela/Guides/issues/9/comments","events_url":"https://api.github.com/repos/Vela/Guides/issues/9/events","html_url":"https://github.com/Vela/Guides/pull/9","id":55645630,"number":9,"title":"Initial API style guide","user":{"login":"jeremyw","id":12091,"avatar_url":"https://avatars.githubusercontent.com/u/12091?v=3","gravatar_id":"","url":"https://api.github.com/users/jeremyw","html_url":"https://github.com/jeremyw","followers_url":"https://api.github.com/users/jeremyw/followers","following_url":"https://api.github.com/users/jeremyw/following{/other_user}","gists_url":"https://api.github.com/users/jeremyw/gists{/gist_id}","starred_url":"https://api.github.com/users/jeremyw/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jeremyw/subscriptions","organizations_url":"https://api.github.com/users/jeremyw/orgs","repos_url":"https://api.github.com/users/jeremyw/repos","events_url":"https://api.github.com/users/jeremyw/events{/privacy}","received_events_url":"https://api.github.com/users/jeremyw/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":18,"created_at":"2015-01-27T17:10:39Z","updated_at":"2015-01-27T20:04:16Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/Vela/Guides/pulls/9","html_url":"https://github.com/Vela/Guides/pull/9","diff_url":"https://github.com/Vela/Guides/pull/9.diff","patch_url":"https://github.com/Vela/Guides/pull/9.patch"},"body":"@mdenomy @gwithers @matrixsc @thegreatape @joelind @DanLuchi @kdsingharneja @atkinss Please review/add content"},"comment":{"url":"https://api.github.com/repos/Vela/Guides/issues/comments/71717723","html_url":"https://github.com/Vela/Guides/pull/9#issuecomment-71717723","issue_url":"https://api.github.com/repos/Vela/Guides/issues/9","id":71717723,"user":{"login":"kdsingharneja","id":3587540,"avatar_url":"https://avatars.githubusercontent.com/u/3587540?v=3","gravatar_id":"","url":"https://api.github.com/users/kdsingharneja","html_url":"https://github.com/kdsingharneja","followers_url":"https://api.github.com/users/kdsingharneja/followers","following_url":"https://api.github.com/users/kdsingharneja/following{/other_user}","gists_url":"https://api.github.com/users/kdsingharneja/gists{/gist_id}","starred_url":"https://api.github.com/users/kdsingharneja/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kdsingharneja/subscriptions","organizations_url":"https://api.github.com/users/kdsingharneja/orgs","repos_url":"https://api.github.com/users/kdsingharneja/repos","events_url":"https://api.github.com/users/kdsingharneja/events{/privacy}","received_events_url":"https://api.github.com/users/kdsingharneja/received_events","type":"User","site_admin":false},"created_at":"2015-01-27T20:04:16Z","updated_at":"2015-01-27T20:04:16Z","body":"@jeremyw Of course, 4 element is not ideal, but again it is the use of the namespace we have to watchout for. For example, api/v1 is something we came up with, perhaps due to it being a public api. I have never seen version numbers in api urls. Hence, IMHO version numbers should not be in namespaces, at least not \"v1\", but again that is spilt milk under the bridge\r\n\r\nAs for name spacing, from what I understood is good from controllers point of perspective, where they are mainly inward facing resources and APIs do not have to be shared. For example when we refactor issues (only a Field thing), it would be good to create a namespace around it, let each different sub view around it be a sub namespace, but not \"v1\" nomenclature. So just 2 or max 3 level. If it a very specific 4th level is needed, then we should look at the design again."}}