Intro to Kubernetes Docs

on YouTube ↗26m

" summary

Kubernetes docs live in the website repo (k8s.io) as markdown rendered by Hugo with a customized doxy theme; source lives on GitHub, CI uses Prow + Netlify for preview builds and continuous deploy to master. Contributors run make container-image and make container-serve to test locally at localhost:1313. The project supports 13 localized languages, requires a CLA, uses labels like lgtm and approved for merge, and treats small edits (spelling, grammar) and full pages equally.

AI-written summary · about

" chapters (23)

1. 0:00Intro
2. 0:19SIG Docs
3. 0:54Website: Concepts
4. 1:08Website: Tasks
5. 1:48Community
6. 2:28Source control
7. 2:45Markdown
8. 3:14Where to Start
9. 4:09Contributor License Agreement
10. 5:20Templating
11. 5:54Code review automation
12. 6:30Automatic preview
13. 7:34Continuous deployment
14. 10:20Local preview
15. 11:30Contribution
16. 12:21Style
17. 13:19Getting going
18. 14:10Writing great docs
19. 17:29Pull request wrangler
20. 18:34Localization
21. 23:08Recap
22. 23:56Next steps
23. 24:18Get in touch

" related talks

• 32mKubernetes SIG Docs: A Deep DiveBrad Topol, Jim Angel, Chris Metz · KubeCon + CloudNativeCon North America 2021
• 01h 04mIntro + Deep Dive: Kubernetes (Docs) SIGZach Corleissen, Rael Garcia · KubeCon + CloudNativeCon Europe 2019
• 26mGetting Involved in Kubernetes SIG Docs and Korean LocalizationSon Seokho, Ian Choi · Kubernetes Forum Seoul 2019
• 32mBridge the Gap To OSS Adoption With Documentation: A Kubernetes StoryNatali Vlatko, Divya Mohan · KubeCon + CloudNativeCon Europe 2025
• 39mWhat's in a Word? Lessons from Localizing Kubernetes Documentation to ArabicAli Dowair · Write the Docs Atlantic 2024
• 36mBuilding Docs like Code: Continuous Integration for DocumentationMason Egger · PyCon Latam 2019
• 25mBuilding Docs like Code: Continuous Integration for DocumentationMason Egger · PyOhio 2019
• 29mMaking Tech Documentation Better, Easier, And Less BoringBilawal Maheed · EuRuKo 2019