Merge pull request #3520 from chrislovecnm/api-docs-updates

Automatic merge from submit-queue.

API docs updates

- tweak to .gitignore
- updating api docs
- updated docs/apireference/README.md with how to generate docs

@justinsb any idea what happened to the hack script? `hack/make-gendocs.sh` did not work last time I tried to do this, but I updated the instructions in the `docs/apireference/README.md` for how to get it to work now.

.gitignore

@@ -68,3 +68,5 @@ bazel-genfiles
 bazel-kops
 bazel-out
 bazel-testlogs
+# Ignore default apiserver config
+apiserver.local.config

docs/apireference/README.md

@@ -13,8 +13,11 @@ go get -u github.com/kubernetes-incubator/apiserver-builder/cmd/...
 # Install the reference docs commands (apiserver-builder commands invoke these)
 go get -u github.com/kubernetes-incubator/reference-docs/gen-apidocs/...
 
+go get -u k8s.io/code-generator/...
 # Install the code generation commands (apiserver-builder commands invoke these)
 go install k8s.io/code-generator/cmd/openapi-gen
+go install k8s.io/code-generator/cmd/deepcopy-gen
+go install k8s.io/code-generator/cmd/informer-gen
 ```
 
 ## Update the `pkg/openapi/openapi_generated.go`

docs/apireference/build/brodoc.js

@@ -153,7 +153,7 @@ function generateNestedNav(parent, nest) {
 
 function generateNavJson(data) {
     var navJson = JSON.stringify(data);
-    navScript = `(function(){navData = ${navJson}})();`;
+    navScript = `(function(){navData = ${navJson};})();`;
     fs.writeFile('./navData.js', navScript, function(err) {
         if (err) {
             return console.log(err);