{"action":"opened","issue":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/9753","labels_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/9753/labels{/name}","comments_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/9753/comments","events_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/9753/events","html_url":"https://github.com/GoogleCloudPlatform/kubernetes/issues/9753","id":87878001,"number":9753,"title":"api documentation is not aimed at kubectl users","user":{"login":"erictune","id":8105590,"avatar_url":"https://avatars.githubusercontent.com/u/8105590?v=3","gravatar_id":"","url":"https://api.github.com/users/erictune","html_url":"https://github.com/erictune","followers_url":"https://api.github.com/users/erictune/followers","following_url":"https://api.github.com/users/erictune/following{/other_user}","gists_url":"https://api.github.com/users/erictune/gists{/gist_id}","starred_url":"https://api.github.com/users/erictune/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/erictune/subscriptions","organizations_url":"https://api.github.com/users/erictune/orgs","repos_url":"https://api.github.com/users/erictune/repos","events_url":"https://api.github.com/users/erictune/events{/privacy}","received_events_url":"https://api.github.com/users/erictune/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels/kind/documentation","name":"kind/documentation","color":"c7def8"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-06-12T23:14:57Z","updated_at":"2015-06-12T23:14:57Z","closed_at":null,"body":"We have lots of api documentation in docs/api.md and docs/api-conventions.md.  But it is focused\r\non direct REST access and on how to extend the API.\r\n\r\nWe need documentation which is for people who:\r\n  - will interact mostly with kubectl \r\n    - gloss over REST/HTTP\r\n  - don't plan on extending the API \r\n    - less prescriptive tone, less design discussion\r\n  - are not thinking about the problem of multiple api versions yet\r\n   - deemphasize the version stuff.\r\n\r\n"}}