{"action":"created","issue":{"url":"https://api.github.com/repos/dart-lang/dartdoc/issues/6","labels_url":"https://api.github.com/repos/dart-lang/dartdoc/issues/6/labels{/name}","comments_url":"https://api.github.com/repos/dart-lang/dartdoc/issues/6/comments","events_url":"https://api.github.com/repos/dart-lang/dartdoc/issues/6/events","html_url":"https://github.com/dart-lang/dartdoc/issues/6","id":48550745,"number":6,"title":"Produce a machine-readable format","user":{"login":"sethladd","id":5479,"avatar_url":"https://avatars.githubusercontent.com/u/5479?v=3","gravatar_id":"","url":"https://api.github.com/users/sethladd","html_url":"https://github.com/sethladd","followers_url":"https://api.github.com/users/sethladd/followers","following_url":"https://api.github.com/users/sethladd/following{/other_user}","gists_url":"https://api.github.com/users/sethladd/gists{/gist_id}","starred_url":"https://api.github.com/users/sethladd/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sethladd/subscriptions","organizations_url":"https://api.github.com/users/sethladd/orgs","repos_url":"https://api.github.com/users/sethladd/repos","events_url":"https://api.github.com/users/sethladd/events{/privacy}","received_events_url":"https://api.github.com/users/sethladd/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/dart-lang/dartdoc/labels/enhancement","name":"enhancement","color":"84b6eb"},{"url":"https://api.github.com/repos/dart-lang/dartdoc/labels/P1","name":"P1","color":"eb6420"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2014-11-12T19:21:21Z","updated_at":"2015-03-20T18:08:17Z","closed_at":null,"body":"Producing a file that is machine readable (such as a JSON file) helps enable mashups and unforeseen applications. For example, Dart's current docgen tool output JSON, and that lead to an API diff tool and an API score tool."},"comment":{"url":"https://api.github.com/repos/dart-lang/dartdoc/issues/comments/84090849","html_url":"https://github.com/dart-lang/dartdoc/issues/6#issuecomment-84090849","issue_url":"https://api.github.com/repos/dart-lang/dartdoc/issues/6","id":84090849,"user":{"login":"srawlins","id":103167,"avatar_url":"https://avatars.githubusercontent.com/u/103167?v=3","gravatar_id":"","url":"https://api.github.com/users/srawlins","html_url":"https://github.com/srawlins","followers_url":"https://api.github.com/users/srawlins/followers","following_url":"https://api.github.com/users/srawlins/following{/other_user}","gists_url":"https://api.github.com/users/srawlins/gists{/gist_id}","starred_url":"https://api.github.com/users/srawlins/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/srawlins/subscriptions","organizations_url":"https://api.github.com/users/srawlins/orgs","repos_url":"https://api.github.com/users/srawlins/repos","events_url":"https://api.github.com/users/srawlins/events{/privacy}","received_events_url":"https://api.github.com/users/srawlins/received_events","type":"User","site_admin":false},"created_at":"2015-03-20T18:08:17Z","updated_at":"2015-03-20T18:08:17Z","body":"Yeah I'm all in favor of keeping a machine-readable format (particularly the current JSON one :) ). Shapeshift [uses it](https://github.com/google/dart-shapeshift/blob/master/lib/src/cli/package_reporter.dart#L21) to compare two different JSON blobs representing two releases of the same API.\r\n\r\nAlso Doc Coverage (in the same repo as Shapeshift) [uses it](https://github.com/google/dart-shapeshift/blob/master/lib/src/frontend/class_doc_analyzer.dart#L24) to score a package's documentation coverage. This tool relies on these JSONs being available over HTTP, which we can hopefully keep :)"}}