{"action":"created","issue":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/11357","labels_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/11357/labels{/name}","comments_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/11357/comments","events_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/11357/events","html_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/11357","id":95337711,"number":11357,"title":"generate docs for types defined in pkg/api/v*/types.go","user":{"login":"caesarxuchao","id":2823529,"avatar_url":"https://avatars.githubusercontent.com/u/2823529?v=3","gravatar_id":"","url":"https://api.github.com/users/caesarxuchao","html_url":"https://github.com/caesarxuchao","followers_url":"https://api.github.com/users/caesarxuchao/followers","following_url":"https://api.github.com/users/caesarxuchao/following{/other_user}","gists_url":"https://api.github.com/users/caesarxuchao/gists{/gist_id}","starred_url":"https://api.github.com/users/caesarxuchao/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/caesarxuchao/subscriptions","organizations_url":"https://api.github.com/users/caesarxuchao/orgs","repos_url":"https://api.github.com/users/caesarxuchao/repos","events_url":"https://api.github.com/users/caesarxuchao/events{/privacy}","received_events_url":"https://api.github.com/users/caesarxuchao/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels/cla:%20yes","name":"cla: yes","color":"bfe5bf"},{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels/kind/documentation","name":"kind/documentation","color":"c7def8"},{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels/lgtm","name":"lgtm","color":"159818"},{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels/ok-to-merge","name":"ok-to-merge","color":"fbca04"}],"state":"open","locked":false,"assignee":{"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},"milestone":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/milestones/6","html_url":"https://github.com/GoogleCloudPlatform/kubernetes/milestones/v1.0","labels_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/milestones/6/labels","id":969317,"number":6,"title":"v1.0","description":"Issues that need to be resolved for v1.0 of Kubernetes.","creator":{"login":"goltermann","id":9358478,"avatar_url":"https://avatars.githubusercontent.com/u/9358478?v=3","gravatar_id":"","url":"https://api.github.com/users/goltermann","html_url":"https://github.com/goltermann","followers_url":"https://api.github.com/users/goltermann/followers","following_url":"https://api.github.com/users/goltermann/following{/other_user}","gists_url":"https://api.github.com/users/goltermann/gists{/gist_id}","starred_url":"https://api.github.com/users/goltermann/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/goltermann/subscriptions","organizations_url":"https://api.github.com/users/goltermann/orgs","repos_url":"https://api.github.com/users/goltermann/repos","events_url":"https://api.github.com/users/goltermann/events{/privacy}","received_events_url":"https://api.github.com/users/goltermann/received_events","type":"User","site_admin":false},"open_issues":45,"closed_issues":763,"state":"open","created_at":"2015-02-06T20:27:16Z","updated_at":"2015-07-17T22:23:05Z","due_on":null,"closed_at":null},"comments":23,"created_at":"2015-07-16T03:09:53Z","updated_at":"2015-07-17T22:48:01Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/11357","html_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/11357","diff_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/11357.diff","patch_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/11357.patch"},"body":"Adapted from OpenShift code [here](https://github.com/openshift/origin/blob/master/hack/gen-swagger-docs.sh ) and [here](https://github.com/openshift/origin/blob/master/hack/gen-swagger-docs.sh)\r\n\r\nreplace #11253\r\n\r\nref #9097\r\n\r\ngen-swagger-docs.sh will generate two .html files for REST Paths (paths.html)and Models(definition.html). In definition.html, there is a TOC listing all the top-level API types.\r\n\r\nDepends on gradle, Swagger2MarkupConverter, asciidoctor.\r\n\r\nToDo:\r\n1. we need to add content to model.description to our types.go. Once done, it will be populated into the output .html files.\r\n2. improve the hardcode \"v1\" in gen-swagger-docs.sh\r\n3. improve the look of the TOC.\r\n\r\n@smarterclayton @erictune @bgrant0607 @thockin "},"comment":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/comments/122438679","html_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/11357#issuecomment-122438679","issue_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/11357","id":122438679,"user":{"login":"caesarxuchao","id":2823529,"avatar_url":"https://avatars.githubusercontent.com/u/2823529?v=3","gravatar_id":"","url":"https://api.github.com/users/caesarxuchao","html_url":"https://github.com/caesarxuchao","followers_url":"https://api.github.com/users/caesarxuchao/followers","following_url":"https://api.github.com/users/caesarxuchao/following{/other_user}","gists_url":"https://api.github.com/users/caesarxuchao/gists{/gist_id}","starred_url":"https://api.github.com/users/caesarxuchao/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/caesarxuchao/subscriptions","organizations_url":"https://api.github.com/users/caesarxuchao/orgs","repos_url":"https://api.github.com/users/caesarxuchao/repos","events_url":"https://api.github.com/users/caesarxuchao/events{/privacy}","received_events_url":"https://api.github.com/users/caesarxuchao/received_events","type":"User","site_admin":false},"created_at":"2015-07-17T22:48:01Z","updated_at":"2015-07-17T22:48:01Z","body":"Squashed. Thank you."}}