{"action":"created","issue":{"url":"https://api.github.com/repos/mozilla-services/protocol/issues/1","labels_url":"https://api.github.com/repos/mozilla-services/protocol/issues/1/labels{/name}","comments_url":"https://api.github.com/repos/mozilla-services/protocol/issues/1/comments","events_url":"https://api.github.com/repos/mozilla-services/protocol/issues/1/events","html_url":"https://github.com/mozilla-services/protocol/issues/1","id":56259464,"number":1,"title":"general rules vs storage","user":{"login":"tarekziade","id":250019,"avatar_url":"https://avatars.githubusercontent.com/u/250019?v=3","gravatar_id":"","url":"https://api.github.com/users/tarekziade","html_url":"https://github.com/tarekziade","followers_url":"https://api.github.com/users/tarekziade/followers","following_url":"https://api.github.com/users/tarekziade/following{/other_user}","gists_url":"https://api.github.com/users/tarekziade/gists{/gist_id}","starred_url":"https://api.github.com/users/tarekziade/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tarekziade/subscriptions","organizations_url":"https://api.github.com/users/tarekziade/orgs","repos_url":"https://api.github.com/users/tarekziade/repos","events_url":"https://api.github.com/users/tarekziade/events{/privacy}","received_events_url":"https://api.github.com/users/tarekziade/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":8,"created_at":"2015-02-02T16:38:33Z","updated_at":"2015-02-03T15:19:15Z","closed_at":null,"body":"we should separate and isolate two different elements (and probably in two specific documents)\r\n\r\n- general rules: anything like a header, that can be used on any web service (sync, easy setup, etc)\r\n- storage protocol: how to store and retrieve items, how to sync them etc\r\n\r\nthe first one was already described in the past - partially implemented by mozsvc+cornice, and by going through all projects in http://docs.services.mozilla.com/#services we can probably get more feedback to build the document.\r\n\r\nthe second one is specifically what we are interested into for our cloud storage project and for the reading list as well. I would tentatively summarize it as: \r\n\r\nAn fxa-attached storage that can be used directly by the client or by an application server,\r\nwith helpers to synchronize items between devices belonging to the same FxA account.\r\n\r\nThat includes stuff like \"batch operations\" - \"race condition\" etc."},"comment":{"url":"https://api.github.com/repos/mozilla-services/protocol/issues/comments/72668168","html_url":"https://github.com/mozilla-services/protocol/issues/1#issuecomment-72668168","issue_url":"https://api.github.com/repos/mozilla-services/protocol/issues/1","id":72668168,"user":{"login":"tarekziade","id":250019,"avatar_url":"https://avatars.githubusercontent.com/u/250019?v=3","gravatar_id":"","url":"https://api.github.com/users/tarekziade","html_url":"https://github.com/tarekziade","followers_url":"https://api.github.com/users/tarekziade/followers","following_url":"https://api.github.com/users/tarekziade/following{/other_user}","gists_url":"https://api.github.com/users/tarekziade/gists{/gist_id}","starred_url":"https://api.github.com/users/tarekziade/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tarekziade/subscriptions","organizations_url":"https://api.github.com/users/tarekziade/orgs","repos_url":"https://api.github.com/users/tarekziade/repos","events_url":"https://api.github.com/users/tarekziade/events{/privacy}","received_events_url":"https://api.github.com/users/tarekziade/received_events","type":"User","site_admin":false},"created_at":"2015-02-03T15:19:15Z","updated_at":"2015-02-03T15:19:15Z","body":"@ametaireau you did not answer to my two questions here: https://github.com/mozilla-services/protocol/issues/1#issuecomment-72660530\r\n\r\nalso, I think we should add a glossary and define precisely each word we use. The first one would be 'protocol'\r\n"}}