kubernetes-conventions/README.md

Kubernetes Patterns

Production-scale Go patterns extracted from the Kubernetes source code with verified file:line citations.

Structure

• patterns/ — Kubernetes-specific patterns (controller, reconciler, informer, workqueue, scheme)
• comparison/ — Go stdlib vs Kubernetes approaches
• smells/ — Anti-patterns at scale
• changelog/ — Daily digest of merged Kubernetes PRs

Philosophy

These rules are derived from what the Kubernetes source code actually does, not opinions or blog posts. Every pattern cites specific files and line numbers.

Kubernetes shows what idiomatic Go looks like at scale — patterns that emerge only when a project hits millions of lines.