{"action":"created","issue":{"url":"https://api.github.com/repos/kubernetes/kubernetes/issues/15193","labels_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/15193/labels{/name}","comments_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/15193/comments","events_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/15193/events","html_url":"https://github.com/kubernetes/kubernetes/issues/15193","id":110121611,"number":15193,"title":"Document how examples should be written and convert existing examples to the desired format","user":{"login":"bgrant0607","id":7725777,"avatar_url":"https://avatars.githubusercontent.com/u/7725777?v=3","gravatar_id":"","url":"https://api.github.com/users/bgrant0607","html_url":"https://github.com/bgrant0607","followers_url":"https://api.github.com/users/bgrant0607/followers","following_url":"https://api.github.com/users/bgrant0607/following{/other_user}","gists_url":"https://api.github.com/users/bgrant0607/gists{/gist_id}","starred_url":"https://api.github.com/users/bgrant0607/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bgrant0607/subscriptions","organizations_url":"https://api.github.com/users/bgrant0607/orgs","repos_url":"https://api.github.com/users/bgrant0607/repos","events_url":"https://api.github.com/users/bgrant0607/events{/privacy}","received_events_url":"https://api.github.com/users/bgrant0607/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/kubernetes/kubernetes/labels/kind/documentation","name":"kind/documentation","color":"c7def8"},{"url":"https://api.github.com/repos/kubernetes/kubernetes/labels/priority/P1","name":"priority/P1","color":"eb6420"},{"url":"https://api.github.com/repos/kubernetes/kubernetes/labels/team/ux","name":"team/ux","color":"d2b48c"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-10-06T23:20:09Z","updated_at":"2015-10-07T00:06:51Z","closed_at":null,"body":"Forked from https://github.com/kubernetes/kubernetes/issues/4926#issuecomment-78006098, #9399, #11361, and other issues.\r\n\r\nWe need to decide how we want examples to be written, document that, and make existing examples conform.\r\n\r\nThere is a tension between conflicting objectives: teaching system concepts, demonstrating system features, getting started quickly with a particular application, providing sample configurations that can be extended by the user for real use cases, ...\r\n\r\ncc @aronchick "},"comment":{"url":"https://api.github.com/repos/kubernetes/kubernetes/issues/comments/146040160","html_url":"https://github.com/kubernetes/kubernetes/issues/15193#issuecomment-146040160","issue_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/15193","id":146040160,"user":{"login":"bgrant0607","id":7725777,"avatar_url":"https://avatars.githubusercontent.com/u/7725777?v=3","gravatar_id":"","url":"https://api.github.com/users/bgrant0607","html_url":"https://github.com/bgrant0607","followers_url":"https://api.github.com/users/bgrant0607/followers","following_url":"https://api.github.com/users/bgrant0607/following{/other_user}","gists_url":"https://api.github.com/users/bgrant0607/gists{/gist_id}","starred_url":"https://api.github.com/users/bgrant0607/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bgrant0607/subscriptions","organizations_url":"https://api.github.com/users/bgrant0607/orgs","repos_url":"https://api.github.com/users/bgrant0607/repos","events_url":"https://api.github.com/users/bgrant0607/events{/privacy}","received_events_url":"https://api.github.com/users/bgrant0607/received_events","type":"User","site_admin":false},"created_at":"2015-10-07T00:06:51Z","updated_at":"2015-10-07T00:06:51Z","body":"There is overlap with the quick walkthrough:\r\nhttps://github.com/kubernetes/kubernetes/tree/master/docs/user-guide/walkthrough\r\n\r\nAnd with the detailed walkthrough:\r\nhttps://github.com/kubernetes/kubernetes/tree/master/docs/user-guide#thorough-walkthrough\r\n"}}