Website: Issue with k8s.io/docs/home/ Example buttons do not work

[rschooley]

This is a Bug Report

Problem:
The "kubectl example" and "curl example" buttons do not currently work.

Bootstrap fails to load and I'm guessing the toggle for the details panel is handled by that.

Proposed Solution:
Make sure the file is deployed: https://kubernetes.io/js/bootstrap-3.3.7.min.js
or just use a CDN

Page to Update:
https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.16

Additional Information

[savitharaghunathan]

/kind bug

[savitharaghunathan]

1.16 is pointing to 3.3.7. Updating it to point to v4.3.1 (https://kubernetes.io/js/bootstrap-4.3.1.min.js )should make these buttons work.

[medmedchiheb]

Yes should work but the change must be made in the api reference generator

[medmedchiheb]

/assign

[aimeeu]

@medmedchiheb Thanks for assigning this to yourself! I'm not very familiar with the kubernetes-incubator/reference-docs. Is it possible to point to a CDN instead of updating bootstrap.min.js ? Also, updating reference-docs is the long-term fix. Since the process of generating the API docs is started manually, how do we update the content in kubernetes/website/static/docs/reference/generated/kubernetes-api?

[medmedchiheb]

It's just a quick fix, as you can see from the template.
And then you can test by executing update-imported-docs

https://github.com/kubernetes-incubator/reference-docs/blob/88f6483855ac68ee6041cd8e90169f7f5268dc2b/gen-apidocs/generators/html.go#L604

[sftim]

/priority backlog
(definitely worth fixing though)

[aimeeu]

this is two-fold: 1) update the code in the kubernetes-incubutor/reference-docs project (longterm fix); and 2) update kubernetes/website/static..... See Slack thread

[medmedchiheb]

already fixed bootstrap version

https://github.com/kubernetes-incubator/reference-docs/blob/6c1496ba33b6aed9ab6af886412e8487f534194e/gen-apidocs/generators/html.go#L604

[aimeeu]

/remove-priority backlog
/priority critical-urgent

Updating the current generated API doc index.html is critical because the buttons don't work (see #16263 for v1.15). Long-term fix has already been added to kubernetes-incubator/reference-docs.

[sftim]

/lifecycle active