{"action":"created","issue":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/2970","labels_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/2970/labels{/name}","comments_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/2970/comments","events_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/2970/events","html_url":"https://github.com/GoogleCloudPlatform/kubernetes/issues/2970","id":52135103,"number":2970,"title":"Systematically tag readonly API fields","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/GoogleCloudPlatform/kubernetes/labels/api/cluster","name":"api/cluster","color":"e1ed21"},{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels/area/documentation","name":"area/documentation","color":"5319e7"},{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels/area/usability","name":"area/usability","color":"00cc00"},{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels/priority/P2","name":"priority/P2","color":"fbca04"},{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels/team/UX","name":"team/UX","color":"d2b48c"}],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/milestones/9","labels_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/milestones/9/labels","id":969321,"number":9,"title":"Doc Fixit","description":"Fix v1 doc issues.","creator":{"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},"open_issues":17,"closed_issues":2,"state":"open","created_at":"2015-02-06T20:30:30Z","updated_at":"2015-02-12T00:04:16Z","due_on":"2015-03-11T07:00:00Z","closed_at":null},"comments":3,"created_at":"2014-12-16T16:34:08Z","updated_at":"2015-02-18T00:49:13Z","closed_at":null,"body":"Right now we have haphazard comments regarding which fields are read-only/output-only, and many, such as `uid` aren't documented at all.\r\n\r\nSwagger 2.0 actually supports a `readOnly` property tag, but we're using Swagger 1.2, which does not, officially. The official meaning doesn't match what we want, though. `readOnly` fields must not be included in a PUT, which would be painful for clients. We could simply document our convention, however.\r\n\r\nWe should tag fields as readonly. Maybe we could have go-restful automatically add a comment to the description in that case."},"comment":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/comments/74788865","html_url":"https://github.com/GoogleCloudPlatform/kubernetes/issues/2970#issuecomment-74788865","issue_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/2970","id":74788865,"user":{"login":"nikhiljindal","id":10199099,"avatar_url":"https://avatars.githubusercontent.com/u/10199099?v=3","gravatar_id":"","url":"https://api.github.com/users/nikhiljindal","html_url":"https://github.com/nikhiljindal","followers_url":"https://api.github.com/users/nikhiljindal/followers","following_url":"https://api.github.com/users/nikhiljindal/following{/other_user}","gists_url":"https://api.github.com/users/nikhiljindal/gists{/gist_id}","starred_url":"https://api.github.com/users/nikhiljindal/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nikhiljindal/subscriptions","organizations_url":"https://api.github.com/users/nikhiljindal/orgs","repos_url":"https://api.github.com/users/nikhiljindal/repos","events_url":"https://api.github.com/users/nikhiljindal/events{/privacy}","received_events_url":"https://api.github.com/users/nikhiljindal/received_events","type":"User","site_admin":false},"created_at":"2015-02-18T00:49:13Z","updated_at":"2015-02-18T00:49:13Z","body":"go-restful (the framework that we are using to generate swagger-spec) does not support 2.0 yet: https://github.com/emicklei/go-restful/issues/157"}}