{"action":"created","issue":{"url":"https://api.github.com/repos/kubernetes/kubernetes/issues/21817","repository_url":"https://api.github.com/repos/kubernetes/kubernetes","labels_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/21817/labels{/name}","comments_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/21817/comments","events_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/21817/events","html_url":"https://github.com/kubernetes/kubernetes/issues/21817","id":135911367,"number":21817,"title":"Proposal to rework examples.","user":{"login":"jayunit100","id":826111,"avatar_url":"https://avatars.githubusercontent.com/u/826111?v=3","gravatar_id":"","url":"https://api.github.com/users/jayunit100","html_url":"https://github.com/jayunit100","followers_url":"https://api.github.com/users/jayunit100/followers","following_url":"https://api.github.com/users/jayunit100/following{/other_user}","gists_url":"https://api.github.com/users/jayunit100/gists{/gist_id}","starred_url":"https://api.github.com/users/jayunit100/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jayunit100/subscriptions","organizations_url":"https://api.github.com/users/jayunit100/orgs","repos_url":"https://api.github.com/users/jayunit100/repos","events_url":"https://api.github.com/users/jayunit100/events{/privacy}","received_events_url":"https://api.github.com/users/jayunit100/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/kubernetes/kubernetes/labels/kind/example","name":"kind/example","color":"c7def8"},{"url":"https://api.github.com/repos/kubernetes/kubernetes/labels/team/test-infra","name":"team/test-infra","color":"d2b48c"},{"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":4,"created_at":"2016-02-24T00:28:43Z","updated_at":"2016-02-27T01:26:37Z","closed_at":null,"body":"Today in @kubernetes/sig-testing we discussed the idea of improving the examples over time with a new policy, based on.\r\n\r\n- a few, domain driven examples that are artfully curated by developers, i.e., less than 4.\r\n- covering all features in the examples : rather than duplicating the core features using non idiomatic kube techniques.\r\n- converting the existing examples which don't actually \"tell a story\" into a `blueprints/` directory which might be put into contrib.  \r\n - That way, if the mongodb community wants to curate their recipes upstream, they can easily do so, without us having to support then in the e2es.\r\n\r\nI think this should be done slowly.  For now, I think its great for us to keep maintaining the examples/, as many people continue to use them.  We can work with the @kubernetes/sig-big-data @kubernetes/sig-api-machinery  and @kubernetes/sig-auth and other sigs to make sure the pedagogical elements are all addressed. \r\n\r\n"},"comment":{"url":"https://api.github.com/repos/kubernetes/kubernetes/issues/comments/189546884","html_url":"https://github.com/kubernetes/kubernetes/issues/21817#issuecomment-189546884","issue_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/21817","id":189546884,"user":{"login":"ixdy","id":8061296,"avatar_url":"https://avatars.githubusercontent.com/u/8061296?v=3","gravatar_id":"","url":"https://api.github.com/users/ixdy","html_url":"https://github.com/ixdy","followers_url":"https://api.github.com/users/ixdy/followers","following_url":"https://api.github.com/users/ixdy/following{/other_user}","gists_url":"https://api.github.com/users/ixdy/gists{/gist_id}","starred_url":"https://api.github.com/users/ixdy/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ixdy/subscriptions","organizations_url":"https://api.github.com/users/ixdy/orgs","repos_url":"https://api.github.com/users/ixdy/repos","events_url":"https://api.github.com/users/ixdy/events{/privacy}","received_events_url":"https://api.github.com/users/ixdy/received_events","type":"User","site_admin":false},"created_at":"2016-02-27T01:26:37Z","updated_at":"2016-02-27T01:26:37Z","body":"External sites probably shouldn't be linking into documentation in master, since it's likely to break, but we can leave breadcrumbs if we remove examples.\r\n\r\nIdeally the documented examples and the examples e2e tests should be one and the same. The whole idea behind creating the examples e2e tests in the first place was to verify that the documented examples actually worked - xref #10013."}}