{"action":"created","issue":{"url":"https://api.github.com/repos/go-kit/kit/issues/41","labels_url":"https://api.github.com/repos/go-kit/kit/issues/41/labels{/name}","comments_url":"https://api.github.com/repos/go-kit/kit/issues/41/comments","events_url":"https://api.github.com/repos/go-kit/kit/issues/41/events","html_url":"https://github.com/go-kit/kit/pull/41","id":76832284,"number":41,"title":"Provide coherent READMEs for each package.","user":{"login":"peterbourgon","id":114509,"avatar_url":"https://avatars.githubusercontent.com/u/114509?v=3","gravatar_id":"","url":"https://api.github.com/users/peterbourgon","html_url":"https://github.com/peterbourgon","followers_url":"https://api.github.com/users/peterbourgon/followers","following_url":"https://api.github.com/users/peterbourgon/following{/other_user}","gists_url":"https://api.github.com/users/peterbourgon/gists{/gist_id}","starred_url":"https://api.github.com/users/peterbourgon/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/peterbourgon/subscriptions","organizations_url":"https://api.github.com/users/peterbourgon/orgs","repos_url":"https://api.github.com/users/peterbourgon/repos","events_url":"https://api.github.com/users/peterbourgon/events{/privacy}","received_events_url":"https://api.github.com/users/peterbourgon/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-05-15T19:33:54Z","updated_at":"2015-05-16T20:55:39Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/go-kit/kit/pulls/41","html_url":"https://github.com/go-kit/kit/pull/41","diff_url":"https://github.com/go-kit/kit/pull/41.diff","patch_url":"https://github.com/go-kit/kit/pull/41.patch"},"body":"RFCs were a good way to kickstart discussions, but I think we have enough well-formed opinions, and we're far enough along in implementation, that they're no longer necessary to corral discussion. This PR will give each package a succinct README that describes its _raison d'être_, rationale (drawn from RFCs where appropriate) and several usage examples. After that's done, I'll probably archive the RFCs and move the API stability policy to a docs/ folder. Comments and feedback welcome."},"comment":{"url":"https://api.github.com/repos/go-kit/kit/issues/comments/102692247","html_url":"https://github.com/go-kit/kit/pull/41#issuecomment-102692247","issue_url":"https://api.github.com/repos/go-kit/kit/issues/41","id":102692247,"user":{"login":"ChrisHines","id":1060711,"avatar_url":"https://avatars.githubusercontent.com/u/1060711?v=3","gravatar_id":"","url":"https://api.github.com/users/ChrisHines","html_url":"https://github.com/ChrisHines","followers_url":"https://api.github.com/users/ChrisHines/followers","following_url":"https://api.github.com/users/ChrisHines/following{/other_user}","gists_url":"https://api.github.com/users/ChrisHines/gists{/gist_id}","starred_url":"https://api.github.com/users/ChrisHines/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ChrisHines/subscriptions","organizations_url":"https://api.github.com/users/ChrisHines/orgs","repos_url":"https://api.github.com/users/ChrisHines/repos","events_url":"https://api.github.com/users/ChrisHines/events{/privacy}","received_events_url":"https://api.github.com/users/ChrisHines/received_events","type":"User","site_admin":false},"created_at":"2015-05-16T20:55:39Z","updated_at":"2015-05-16T20:55:39Z","body":"LGTM. We should work to put the code examples in the godoc of each package also."}}