docs: Kubernetes production patterns with source citations

2026-04-30 12:10:12 +00:00
commit eee4200c04
6 changed files with 1613 additions and 0 deletions
@@ -0,0 +1,16 @@
+# Kubernetes Patterns
+
+Production-scale Go patterns extracted from the [Kubernetes source code](https://github.com/kubernetes/kubernetes) 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.