{"action":"created","issue":{"url":"https://api.github.com/repos/ga4gh/schemas/issues/287","labels_url":"https://api.github.com/repos/ga4gh/schemas/issues/287/labels{/name}","comments_url":"https://api.github.com/repos/ga4gh/schemas/issues/287/comments","events_url":"https://api.github.com/repos/ga4gh/schemas/issues/287/events","html_url":"https://github.com/ga4gh/schemas/issues/287","id":69109133,"number":287,"title":"It's not clear that the avro schema files are not required to be used in implementations","user":{"login":"Relequestual","id":731158,"avatar_url":"https://avatars.githubusercontent.com/u/731158?v=3","gravatar_id":"","url":"https://api.github.com/users/Relequestual","html_url":"https://github.com/Relequestual","followers_url":"https://api.github.com/users/Relequestual/followers","following_url":"https://api.github.com/users/Relequestual/following{/other_user}","gists_url":"https://api.github.com/users/Relequestual/gists{/gist_id}","starred_url":"https://api.github.com/users/Relequestual/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Relequestual/subscriptions","organizations_url":"https://api.github.com/users/Relequestual/orgs","repos_url":"https://api.github.com/users/Relequestual/repos","events_url":"https://api.github.com/users/Relequestual/events{/privacy}","received_events_url":"https://api.github.com/users/Relequestual/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/ga4gh/schemas/labels/Documentation","name":"Documentation","color":"006b75"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":32,"created_at":"2015-04-17T10:11:00Z","updated_at":"2015-06-06T20:43:13Z","closed_at":null,"body":"I joined the Matchmaker Exchange group late last year. After reading up the work done by GA4GH, I found the avro schema files confusing.\r\n\r\nAfter several working group calls and many emails, I managed to attain the information that the avro files themselves were not inteneded to be used in actual implementations (Cassie set me straight). One sort of exception to this, is the avro files were used to generate classes for the GA4GH server reference implementation.\r\n\r\n(I don't want to get into a debate here over what we're using to document the schemas here, and avro is better at describing a whole protocol, but I'm not convinced it's best for defining and validating json.)\r\n\r\nAfter discussions with others implementing the MME API, there's some confusion over the intension of the avro schema files. We should make it clear that they are for documentation, and you do not NEED to use them to develop your implementation of GA4GH API's."},"comment":{"url":"https://api.github.com/repos/ga4gh/schemas/issues/comments/109646994","html_url":"https://github.com/ga4gh/schemas/issues/287#issuecomment-109646994","issue_url":"https://api.github.com/repos/ga4gh/schemas/issues/287","id":109646994,"user":{"login":"pgrosu","id":6555937,"avatar_url":"https://avatars.githubusercontent.com/u/6555937?v=3","gravatar_id":"","url":"https://api.github.com/users/pgrosu","html_url":"https://github.com/pgrosu","followers_url":"https://api.github.com/users/pgrosu/followers","following_url":"https://api.github.com/users/pgrosu/following{/other_user}","gists_url":"https://api.github.com/users/pgrosu/gists{/gist_id}","starred_url":"https://api.github.com/users/pgrosu/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pgrosu/subscriptions","organizations_url":"https://api.github.com/users/pgrosu/orgs","repos_url":"https://api.github.com/users/pgrosu/repos","events_url":"https://api.github.com/users/pgrosu/events{/privacy}","received_events_url":"https://api.github.com/users/pgrosu/received_events","type":"User","site_admin":false},"created_at":"2015-06-06T20:43:13Z","updated_at":"2015-06-06T20:43:13Z","body":"Heng (@lh3) here's one more thing for you reading list you might find useful:\r\n\r\n[Scuba: Diving into Data at Facebook](http://www.csce.uark.edu/~xintaowu/5203/p767-wiener.pdf)\r\n\r\nThis is Facebook's Scuba for querying at webscale.  Their API implementation is via Thrift though.\r\n\r\n~p"}}