docs: Go patterns vs official guidelines divergence analysis

2026-04-30 07:50:32 -07:00
commit ca07514d9c
2 changed files with 197 additions and 0 deletions
@@ -0,0 +1,18 @@
+# Patterns vs Official Guidelines
+
+Divergence analyses comparing our extracted-from-source patterns against official coding guidelines.
+
+## Reports
+
+| Ecosystem | Our Patterns | Official Guidelines | Report |
+|-----------|-------------|--------------------|---------| 
+| Go | [rodin/go-patterns](https://gitea.weiker.me/rodin/go-patterns) | Effective Go, Code Review Comments, Google Style | [go/](go/) |
+| Elixir | [rodin/elixir-patterns](https://gitea.weiker.me/rodin/elixir-patterns) | CONTRIBUTING.md, Style Guide, HexDocs | [elixir/](elixir/) |
+
+## Philosophy
+
+Official guides tell you what to do. Source patterns show what mature code actually does.
+When they diverge, neither is wrong — they serve different audiences and optimize for
+different things.
+
+This repo documents where they agree, where they differ, and why.