{"action":"created","issue":{"url":"https://api.github.com/repos/vega/vega-lite/issues/1457","repository_url":"https://api.github.com/repos/vega/vega-lite","labels_url":"https://api.github.com/repos/vega/vega-lite/issues/1457/labels{/name}","comments_url":"https://api.github.com/repos/vega/vega-lite/issues/1457/comments","events_url":"https://api.github.com/repos/vega/vega-lite/issues/1457/events","html_url":"https://github.com/vega/vega-lite/issues/1457","id":164193696,"number":1457,"title":"Document deprecation of data.formatType","user":{"login":"adam-iris","id":2521495,"avatar_url":"https://avatars.githubusercontent.com/u/2521495?v=3","gravatar_id":"","url":"https://api.github.com/users/adam-iris","html_url":"https://github.com/adam-iris","followers_url":"https://api.github.com/users/adam-iris/followers","following_url":"https://api.github.com/users/adam-iris/following{/other_user}","gists_url":"https://api.github.com/users/adam-iris/gists{/gist_id}","starred_url":"https://api.github.com/users/adam-iris/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adam-iris/subscriptions","organizations_url":"https://api.github.com/users/adam-iris/orgs","repos_url":"https://api.github.com/users/adam-iris/repos","events_url":"https://api.github.com/users/adam-iris/events{/privacy}","received_events_url":"https://api.github.com/users/adam-iris/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":2,"created_at":"2016-07-06T22:56:07Z","updated_at":"2016-07-08T23:43:53Z","closed_at":"2016-07-07T21:09:18Z","body":"The main example on https://vega.github.io/vega-lite/ includes the old way of specifying the data format:\r\n\r\n    {\r\n      \"data\": {\"url\": \"data/seattle-temps.csv\", \"formatType\": \"csv\"},\r\n      ...\r\n    }\r\n\r\nThis should be updated to the new syntax.\r\n\r\nAs an aside, I have to note that I find this issue extremely worrisome:\r\n\r\n- The example on the home page actually still works, because the format is inferred from the file extension (\".csv\") in the absence of an explicit value. Basically, the system is just smart enough to cover up the error.\r\n- The page on embedding (https://vega.github.io/vega-lite/usage/embed.html) encourages using the \"current\" version of various libraries. This is obviously bad practice, but by encouraging it you suggest to the user that it's at least somewhat safe (eg. you aren't going to push backward-incompatible changes without some sort of mitigation).\r\n- And yet the change is completely backward-incompatible, it doesn't so much as log a warning when it finds the old syntax.\r\n\r\nThe upshot is that use cases suddenly fail without warning, without a clear indication of what's going wrong, and in contradiction to the documentation. (What's going wrong is that the CSV data is being parsed as JSON, but the only way to see this is to look at the stack trace.)\r\n\r\nWe are evaluating Vega/Vega-Lite, and I really like it so far. I would love to start using it widely and be confident in doing so. So I hope this is taken as the constructive criticism that is intended. But this is a **huge** red flag, and I really hope that this sort of consideration gets higher priority in future releases."},"comment":{"url":"https://api.github.com/repos/vega/vega-lite/issues/comments/231497864","html_url":"https://github.com/vega/vega-lite/issues/1457#issuecomment-231497864","issue_url":"https://api.github.com/repos/vega/vega-lite/issues/1457","id":231497864,"user":{"login":"adam-iris","id":2521495,"avatar_url":"https://avatars.githubusercontent.com/u/2521495?v=3","gravatar_id":"","url":"https://api.github.com/users/adam-iris","html_url":"https://github.com/adam-iris","followers_url":"https://api.github.com/users/adam-iris/followers","following_url":"https://api.github.com/users/adam-iris/following{/other_user}","gists_url":"https://api.github.com/users/adam-iris/gists{/gist_id}","starred_url":"https://api.github.com/users/adam-iris/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adam-iris/subscriptions","organizations_url":"https://api.github.com/users/adam-iris/orgs","repos_url":"https://api.github.com/users/adam-iris/repos","events_url":"https://api.github.com/users/adam-iris/events{/privacy}","received_events_url":"https://api.github.com/users/adam-iris/received_events","type":"User","site_admin":false},"created_at":"2016-07-08T23:43:53Z","updated_at":"2016-07-08T23:43:53Z","body":"Thanks for the quick response, and apologies if I ended up ranting a bit. Just got a little frustrated."}}
{"actor":{"display_login":"adam-iris"}}