{"action":"created","issue":{"url":"https://api.github.com/repos/w3c/w3c-api/issues/28","labels_url":"https://api.github.com/repos/w3c/w3c-api/issues/28/labels{/name}","comments_url":"https://api.github.com/repos/w3c/w3c-api/issues/28/comments","events_url":"https://api.github.com/repos/w3c/w3c-api/issues/28/events","html_url":"https://github.com/w3c/w3c-api/issues/28","id":103702328,"number":28,"title":"Inconsistent name for team contacts endpoint and links","user":{"login":"vivienlacourba","id":2012282,"avatar_url":"https://avatars.githubusercontent.com/u/2012282?v=3","gravatar_id":"","url":"https://api.github.com/users/vivienlacourba","html_url":"https://github.com/vivienlacourba","followers_url":"https://api.github.com/users/vivienlacourba/followers","following_url":"https://api.github.com/users/vivienlacourba/following{/other_user}","gists_url":"https://api.github.com/users/vivienlacourba/gists{/gist_id}","starred_url":"https://api.github.com/users/vivienlacourba/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/vivienlacourba/subscriptions","organizations_url":"https://api.github.com/users/vivienlacourba/orgs","repos_url":"https://api.github.com/users/vivienlacourba/repos","events_url":"https://api.github.com/users/vivienlacourba/events{/privacy}","received_events_url":"https://api.github.com/users/vivienlacourba/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/w3c/w3c-api/labels/bug","name":"bug","color":"fc2929"}],"state":"open","locked":false,"assignee":{"login":"jean-gui","id":1479073,"avatar_url":"https://avatars.githubusercontent.com/u/1479073?v=3","gravatar_id":"","url":"https://api.github.com/users/jean-gui","html_url":"https://github.com/jean-gui","followers_url":"https://api.github.com/users/jean-gui/followers","following_url":"https://api.github.com/users/jean-gui/following{/other_user}","gists_url":"https://api.github.com/users/jean-gui/gists{/gist_id}","starred_url":"https://api.github.com/users/jean-gui/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jean-gui/subscriptions","organizations_url":"https://api.github.com/users/jean-gui/orgs","repos_url":"https://api.github.com/users/jean-gui/repos","events_url":"https://api.github.com/users/jean-gui/events{/privacy}","received_events_url":"https://api.github.com/users/jean-gui/received_events","type":"User","site_admin":false},"milestone":null,"comments":0,"created_at":"2015-08-28T11:32:32Z","updated_at":"2015-09-14T14:03:46Z","closed_at":null,"body":"As discussed with @deniak and @tagawa the name of the team contacts endpoint `/groups/*id*/teamcontacts` and the link name used to point to that resource (`_links.team_contacts`) are not consistent (the first one does not contain an `_`).\r\n\r\nThe endpoint: https://api-test.w3.org/groups/40318/teamcontacts\r\n\r\nA link to it as seen in: https://api-test.w3.org/groups/40318\r\n```JSON\r\n\"_links\": {\r\n    \"id\": 40318,\r\n    \"name\": \"HTML Working Group\",\r\n    ...\r\n    \"team_contacts\": \r\n    {\r\n        \"href\": \"https://api-test.w3.org/groups/40318/teamcontacts\"\r\n    },\r\n```\r\n\r\nWe could `s/teamcontacts/team_contacts/g` as all multi-words data attributes are using underscores (eg. `start_date` ) but so far we don't have any endpoint containing an underscore.\r\n\r\nFor the record:\r\n```irc\r\n<denis> vivien, re: s/team_contacts/teamcontacts/, I think we should be consistent. We already have other fields like the feedback dates with that naming convention (e.g. \"last_call_feedback_due)\r\n<vivien> denis, but currently we are not consistent as the endpoint (/groups/ID/teamcontacts) and the link name (_links.team_contacts) are different\r\n...\r\n<vivien> we could do the opposite with s/teamcontacts/team_contacts/ (just that till now we did not had any endpoint with an _)\r\n<denis> we should create an issue vivien\r\n* vivien creates it\r\n<denis> GH is using a '_' in its API results\r\n<denis> but I didn't find any endpoints composed with multiple words\r\n<denis> http://stackoverflow.com/questions/778203/are-there-any-naming-convention-guidelines-for-rest-apis\r\n```"},"comment":{"url":"https://api.github.com/repos/w3c/w3c-api/issues/comments/140085445","html_url":"https://github.com/w3c/w3c-api/issues/28#issuecomment-140085445","issue_url":"https://api.github.com/repos/w3c/w3c-api/issues/28","id":140085445,"user":{"login":"jean-gui","id":1479073,"avatar_url":"https://avatars.githubusercontent.com/u/1479073?v=3","gravatar_id":"","url":"https://api.github.com/users/jean-gui","html_url":"https://github.com/jean-gui","followers_url":"https://api.github.com/users/jean-gui/followers","following_url":"https://api.github.com/users/jean-gui/following{/other_user}","gists_url":"https://api.github.com/users/jean-gui/gists{/gist_id}","starred_url":"https://api.github.com/users/jean-gui/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jean-gui/subscriptions","organizations_url":"https://api.github.com/users/jean-gui/orgs","repos_url":"https://api.github.com/users/jean-gui/repos","events_url":"https://api.github.com/users/jean-gui/events{/privacy}","received_events_url":"https://api.github.com/users/jean-gui/received_events","type":"User","site_admin":false},"created_at":"2015-09-14T14:03:46Z","updated_at":"2015-09-14T14:03:46Z","body":"I don't think that's a real issue. I believe that the problem Apiary is facing is rather related to #32.\r\nI'm not against making the API more consistent, but:\r\n - if we change the property name, it becomes inconsistent with other property names\r\n - if we change the URL, it becomes inconsistent with other URLs\r\nThus, I'd rather leave it as is."}}