docs: idiomatic Phoenix patterns with verified source citations

2026-04-29 23:10:15 -07:00
commit 192195375c
5 changed files with 669 additions and 0 deletions
@@ -0,0 +1,16 @@
+# Phoenix Patterns
+
+Idiomatic Phoenix patterns extracted from the [Phoenix source code](https://github.com/phoenixframework/phoenix) with verified file:line citations.
+
+## Structure
+
+- `patterns/` — Phoenix-specific patterns (Endpoint, Router, Controller, Channel, Plug pipeline, Telemetry)
+- `patterns/deviations.md` — Where Phoenix deliberately differs from Elixir core conventions and why
+- `patterns/comparison.md` — Side-by-side Elixir core vs Phoenix patterns
+- `changelog/` — Daily digest of merged Phoenix PRs with discussion summaries
+
+## Philosophy
+
+These rules are derived from what the Phoenix source code *actually does*, not opinions or blog posts. Every pattern cites specific files and line numbers.
+
+When unsure how to do something in Phoenix, look at how Phoenix itself does it.