Join GitHub today
GitHub is home to over 40 million developers working together to host and review code, manage projects, and build software together.Sign up
Clarify style guide: eliminate most third party content #15576
Improve the K8s style guide
The style guide needs to specify that K8s docs decline to host specific kinds of content:
Why does this matter?
It's necessary to clarify which kinds of content we do and don't accept in K8s docs.
Which page requires an update?
@zacharysarah While poking around the docs I noticed vendor-specific pages under Tasks/Monitorin, Logging, and Debugging for Stackdriver and the Elastic stack. These pages also are targeted at Google Cloud Engine installations. I didn't find an open issue to keep track of pages that contain vendor-specific content. Is there someplace we are logging these?
Good point. Yes, I think that's OK--
UPDATE: rkt is a good example of why linking is better than hosting, given that rkt's archiving from the CNCF. If we hosted rkt docs, we'd have to remove them instead of just removing a link.