Fix files to be valid JSONs

 - [x] When updating any of api/ files be sure to run make api to regenerate api/openshift.html
 - Validate files before regenerating api docs in #307
buildconfig isn't going away, so we should make this a valid example.