{"action":"created","issue":{"url":"https://api.github.com/repos/Microsoft/api-guidelines/issues/29","repository_url":"https://api.github.com/repos/Microsoft/api-guidelines","labels_url":"https://api.github.com/repos/Microsoft/api-guidelines/issues/29/labels{/name}","comments_url":"https://api.github.com/repos/Microsoft/api-guidelines/issues/29/comments","events_url":"https://api.github.com/repos/Microsoft/api-guidelines/issues/29/events","html_url":"https://github.com/Microsoft/api-guidelines/pull/29","id":166526472,"number":29,"title":"Replace REST and RESTful appropriately","user":{"login":"AlexZeitler","id":287480,"avatar_url":"https://avatars.githubusercontent.com/u/287480?v=3","gravatar_id":"","url":"https://api.github.com/users/AlexZeitler","html_url":"https://github.com/AlexZeitler","followers_url":"https://api.github.com/users/AlexZeitler/followers","following_url":"https://api.github.com/users/AlexZeitler/following{/other_user}","gists_url":"https://api.github.com/users/AlexZeitler/gists{/gist_id}","starred_url":"https://api.github.com/users/AlexZeitler/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/AlexZeitler/subscriptions","organizations_url":"https://api.github.com/users/AlexZeitler/orgs","repos_url":"https://api.github.com/users/AlexZeitler/repos","events_url":"https://api.github.com/users/AlexZeitler/events{/privacy}","received_events_url":"https://api.github.com/users/AlexZeitler/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/Microsoft/api-guidelines/labels/cla-not-required","name":"cla-not-required","color":"009800"}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":47,"created_at":"2016-07-20T08:29:24Z","updated_at":"2016-07-25T13:54:14Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/Microsoft/api-guidelines/pulls/29","html_url":"https://github.com/Microsoft/api-guidelines/pull/29","diff_url":"https://github.com/Microsoft/api-guidelines/pull/29.diff","patch_url":"https://github.com/Microsoft/api-guidelines/pull/29.patch"},"body":"As Roy T. Fielding suggested on [Twitter](https://twitter.com/fielding/status/755551887059857408), I replaced the terms \"REST\" and \"RESTful\" with \"HTTP\" / \"HTTP API\".\r\nI think the guide is a good idea in general but it doesn't consider all aspects of REST (esp. Hypermedia / HATEOAS) so it should not use that terminology.\r\nIf plain HTTP APIs are the design goal (which is ok) they should just be called HTTP APIs."},"comment":{"url":"https://api.github.com/repos/Microsoft/api-guidelines/issues/comments/234959426","html_url":"https://github.com/Microsoft/api-guidelines/pull/29#issuecomment-234959426","issue_url":"https://api.github.com/repos/Microsoft/api-guidelines/issues/29","id":234959426,"user":{"login":"darrelmiller","id":447694,"avatar_url":"https://avatars.githubusercontent.com/u/447694?v=3","gravatar_id":"","url":"https://api.github.com/users/darrelmiller","html_url":"https://github.com/darrelmiller","followers_url":"https://api.github.com/users/darrelmiller/followers","following_url":"https://api.github.com/users/darrelmiller/following{/other_user}","gists_url":"https://api.github.com/users/darrelmiller/gists{/gist_id}","starred_url":"https://api.github.com/users/darrelmiller/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/darrelmiller/subscriptions","organizations_url":"https://api.github.com/users/darrelmiller/orgs","repos_url":"https://api.github.com/users/darrelmiller/repos","events_url":"https://api.github.com/users/darrelmiller/events{/privacy}","received_events_url":"https://api.github.com/users/darrelmiller/received_events","type":"User","site_admin":false},"created_at":"2016-07-25T13:54:14Z","updated_at":"2016-07-25T13:54:14Z","body":"@distobj The practicalities are that there are not enough developers who understand how to take advantage of hypermedia. There are not enough people training other developers on how to do it, and there it a significant amount of unlearning that needs to be done before practical benefits can be seen.  Oh, and tooling vendors haven't figured out how to automate the production of hypermedia APIs.  Also, hypermedia is a long term play with some higher upfront costs.  Sadly many people don't build software with those goal."}}
{"actor":{"display_login":"darrelmiller"}}