{"action":"created","issue":{"url":"https://api.github.com/repos/adlnet/xAPI-Spec/issues/710","labels_url":"https://api.github.com/repos/adlnet/xAPI-Spec/issues/710/labels{/name}","comments_url":"https://api.github.com/repos/adlnet/xAPI-Spec/issues/710/comments","events_url":"https://api.github.com/repos/adlnet/xAPI-Spec/issues/710/events","html_url":"https://github.com/adlnet/xAPI-Spec/pull/710","id":92076666,"number":710,"title":"Part1 section5","user":{"login":"andyjohnson","id":1325035,"avatar_url":"https://avatars.githubusercontent.com/u/1325035?v=3","gravatar_id":"","url":"https://api.github.com/users/andyjohnson","html_url":"https://github.com/andyjohnson","followers_url":"https://api.github.com/users/andyjohnson/followers","following_url":"https://api.github.com/users/andyjohnson/following{/other_user}","gists_url":"https://api.github.com/users/andyjohnson/gists{/gist_id}","starred_url":"https://api.github.com/users/andyjohnson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/andyjohnson/subscriptions","organizations_url":"https://api.github.com/users/andyjohnson/orgs","repos_url":"https://api.github.com/users/andyjohnson/repos","events_url":"https://api.github.com/users/andyjohnson/events{/privacy}","received_events_url":"https://api.github.com/users/andyjohnson/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2015-06-30T12:11:06Z","updated_at":"2015-08-15T18:15:50Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/adlnet/xAPI-Spec/pulls/710","html_url":"https://github.com/adlnet/xAPI-Spec/pull/710","diff_url":"https://github.com/adlnet/xAPI-Spec/pull/710.diff","patch_url":"https://github.com/adlnet/xAPI-Spec/pull/710.patch"},"body":"Probably needs a lot of work and clarity.  REST is largely conceptual and I'm not an expert in it.  Hope this is a good start."},"comment":{"url":"https://api.github.com/repos/adlnet/xAPI-Spec/issues/comments/131416498","html_url":"https://github.com/adlnet/xAPI-Spec/pull/710#issuecomment-131416498","issue_url":"https://api.github.com/repos/adlnet/xAPI-Spec/issues/710","id":131416498,"user":{"login":"rswetnam","id":2905367,"avatar_url":"https://avatars.githubusercontent.com/u/2905367?v=3","gravatar_id":"","url":"https://api.github.com/users/rswetnam","html_url":"https://github.com/rswetnam","followers_url":"https://api.github.com/users/rswetnam/followers","following_url":"https://api.github.com/users/rswetnam/following{/other_user}","gists_url":"https://api.github.com/users/rswetnam/gists{/gist_id}","starred_url":"https://api.github.com/users/rswetnam/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rswetnam/subscriptions","organizations_url":"https://api.github.com/users/rswetnam/orgs","repos_url":"https://api.github.com/users/rswetnam/repos","events_url":"https://api.github.com/users/rswetnam/events{/privacy}","received_events_url":"https://api.github.com/users/rswetnam/received_events","type":"User","site_admin":false},"created_at":"2015-08-15T18:15:50Z","updated_at":"2015-08-15T18:15:50Z","body":"I am somewhat uncomfortable with the proposed title for the section.  - \"xAPI as a 'RESTish' Web Service because:\r\n* It suggests that xAPI is a web service - which it is not\r\n* From a marketing point of view, the term \"RESTish\" doesn't inspire a great deal of confidence in this specification \r\n\r\nRather, if we are going to include a section on ReST, I suggest that the title be something like \"xAPI and ReST\".\r\n\r\nREST is famous for inspiring extremely unproductive flame wars about whether programs are \"pure REST\" and I think that there is a danger that trying to define REST in the document gets the spec sucked into these wars.\r\n\r\nRather, I think the approach should be something that says that programs/learning records stores that want to conform to the xAPI specification should adopt a REST architecture and that communications over the Internet between conforming programs should use HTTP - as opposed to SOAP or some other communications protocol."}}