{"action":"created","issue":{"url":"https://api.github.com/repos/openshift/origin/issues/3830","labels_url":"https://api.github.com/repos/openshift/origin/issues/3830/labels{/name}","comments_url":"https://api.github.com/repos/openshift/origin/issues/3830/comments","events_url":"https://api.github.com/repos/openshift/origin/issues/3830/events","html_url":"https://github.com/openshift/origin/issues/3830","id":96594676,"number":3830,"title":"Swagger Doumentation Descriptions and Verification Missing","user":{"login":"stevekuznetsov","id":7328370,"avatar_url":"https://avatars.githubusercontent.com/u/7328370?v=3","gravatar_id":"","url":"https://api.github.com/users/stevekuznetsov","html_url":"https://github.com/stevekuznetsov","followers_url":"https://api.github.com/users/stevekuznetsov/followers","following_url":"https://api.github.com/users/stevekuznetsov/following{/other_user}","gists_url":"https://api.github.com/users/stevekuznetsov/gists{/gist_id}","starred_url":"https://api.github.com/users/stevekuznetsov/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/stevekuznetsov/subscriptions","organizations_url":"https://api.github.com/users/stevekuznetsov/orgs","repos_url":"https://api.github.com/users/stevekuznetsov/repos","events_url":"https://api.github.com/users/stevekuznetsov/events{/privacy}","received_events_url":"https://api.github.com/users/stevekuznetsov/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-07-22T15:27:50Z","updated_at":"2015-07-22T17:39:50Z","closed_at":null,"body":"We currently store descriptions of our API objects for Swagger in `api/definitions` but we are missing the following definitions:\r\n\r\n```\r\nDescription missing for: policyrule\r\nDescription missing for: ispersonalsubjectaccessreview\r\nDescription missing for: role\r\nDescription missing for: rolebinding\r\nDescription missing for: policy\r\nDescription missing for: policybinding\r\nDescription missing for: resourceaccessreviewresponse\r\nDescription missing for: resourceaccessreview\r\nDescription missing for: namedrole\r\nDescription missing for: namedrolebinding\r\nDescription missing for: subjectaccessreviewresponse\r\nDescription missing for: subjectaccessreview\r\nDescription missing for: policylist\r\nDescription missing for: policybindinglist\r\nDescription missing for: rolebindinglist\r\nDescription missing for: rolelist\r\nDescription missing for: clusterrole\r\nDescription missing for: clusterrolebinding\r\nDescription missing for: clusterpolicy\r\nDescription missing for: clusterpolicybinding\r\nDescription missing for: namedclusterrole\r\nDescription missing for: namedclusterrolebinding\r\nDescription missing for: clusterpolicylist\r\nDescription missing for: clusterpolicybindinglist\r\nDescription missing for: clusterrolebindinglist\r\nDescription missing for: clusterrolelist\r\nDescription missing for: build\r\nDescription missing for: buildspec\r\nDescription missing for: buildstatus\r\nDescription missing for: buildsource\r\nDescription missing for: sourcerevision\r\nDescription missing for: gitsourcerevision\r\nDescription missing for: gitbuildsource\r\nDescription missing for: sourcecontroluser\r\nDescription missing for: buildstrategy\r\nDescription missing for: custombuildstrategy\r\nDescription missing for: dockerbuildstrategy\r\nDescription missing for: sourcebuildstrategy\r\nDescription missing for: buildoutput\r\nDescription missing for: buildconfigspec\r\nDescription missing for: buildconfigstatus\r\nDescription missing for: webhooktrigger\r\nDescription missing for: imagechangetrigger\r\nDescription missing for: buildtriggerpolicy\r\nDescription missing for: buildlist\r\nDescription missing for: buildconfiglist\r\nDescription missing for: genericwebhookevent\r\nDescription missing for: gitinfo\r\nDescription missing for: buildlog\r\nDescription missing for: buildrequest\r\nDescription missing for: buildlogoptions\r\nDescription missing for: deploymentstrategy\r\nDescription missing for: customdeploymentstrategyparams\r\nDescription missing for: recreatedeploymentstrategyparams\r\nDescription missing for: lifecyclehook\r\nDescription missing for: execnewpodhook\r\nDescription missing for: rollingdeploymentstrategyparams\r\nDescription missing for: deploymentconfigspec\r\nDescription missing for: deploymentconfigstatus\r\nDescription missing for: deploymenttriggerpolicy\r\nDescription missing for: deploymenttriggerimagechangeparams\r\nDescription missing for: deploymentdetails\r\nDescription missing for: deploymentcause\r\nDescription missing for: deploymentcauseimagetrigger\r\nDescription missing for: deploymentconfiglist\r\nDescription missing for: deploymentconfigrollback\r\nDescription missing for: deploymentconfigrollbackspec\r\nDescription missing for: imagelist\r\nDescription missing for: image\r\nDescription missing for: imagestreamlist\r\nDescription missing for: imagestream\r\nDescription missing for: imagestreamspec\r\nDescription missing for: namedtagreference\r\nDescription missing for: imagestreamstatus\r\nDescription missing for: namedtageventlist\r\nDescription missing for: tagevent\r\nDescription missing for: imagestreammapping\r\nDescription missing for: imagestreamtag\r\nDescription missing for: imagestreamimage\r\nDescription missing for: dockerimagereference\r\nDescription missing for: oauthaccesstoken\r\nDescription missing for: oauthauthorizetoken\r\nDescription missing for: oauthclient\r\nDescription missing for: oauthclientauthorization\r\nDescription missing for: oauthaccesstokenlist\r\nDescription missing for: oauthauthorizetokenlist\r\nDescription missing for: oauthclientlist\r\nDescription missing for: oauthclientauthorizationlist\r\nDescription missing for: projectlist\r\nDescription missing for: projectspec\r\nDescription missing for: projectstatus\r\nDescription missing for: projectrequest\r\nDescription missing for: routelist\r\nDescription missing for: routespec\r\nDescription missing for: routeport\r\nDescription missing for: routestatus\r\nDescription missing for: routershard\r\nDescription missing for: tlsconfig\r\nDescription missing for: clusternetwork\r\nDescription missing for: clusternetworklist\r\nDescription missing for: hostsubnet\r\nDescription missing for: hostsubnetlist\r\nDescription missing for: template\r\nDescription missing for: templatelist\r\nDescription missing for: parameter\r\nDescription missing for: userlist\r\nDescription missing for: identity\r\nDescription missing for: identitylist\r\nDescription missing for: useridentitymapping\r\n```\r\n\r\nWe also do not have any verification that these descriptions exist."},"comment":{"url":"https://api.github.com/repos/openshift/origin/issues/comments/123803425","html_url":"https://github.com/openshift/origin/issues/3830#issuecomment-123803425","issue_url":"https://api.github.com/repos/openshift/origin/issues/3830","id":123803425,"user":{"login":"stevekuznetsov","id":7328370,"avatar_url":"https://avatars.githubusercontent.com/u/7328370?v=3","gravatar_id":"","url":"https://api.github.com/users/stevekuznetsov","html_url":"https://github.com/stevekuznetsov","followers_url":"https://api.github.com/users/stevekuznetsov/followers","following_url":"https://api.github.com/users/stevekuznetsov/following{/other_user}","gists_url":"https://api.github.com/users/stevekuznetsov/gists{/gist_id}","starred_url":"https://api.github.com/users/stevekuznetsov/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/stevekuznetsov/subscriptions","organizations_url":"https://api.github.com/users/stevekuznetsov/orgs","repos_url":"https://api.github.com/users/stevekuznetsov/repos","events_url":"https://api.github.com/users/stevekuznetsov/events{/privacy}","received_events_url":"https://api.github.com/users/stevekuznetsov/received_events","type":"User","site_admin":false},"created_at":"2015-07-22T17:39:50Z","updated_at":"2015-07-22T17:39:50Z","body":"#3843 Adds descriptions"}}