T

Rodin 7e99faff59 docs: PR discussion analysis — how new patterns are debated and landed

Real PR threads from CockroachDB, Prometheus, and Oban showing:
- Handle pattern (PR #142059): 2.5 months, trace span issues discovered in review
- slog migration (PR #14906): 'merge and iterate', 162 files, one commit for 3.0
- AppenderV2 (issue #17632): maintainer pushback defeated by 'it's not user-facing'
- Oban inline testing (PR #684): <24h, zero discussion, solo maintainer

Key insight: 'merge and iterate' beats 'perfect before merge' for
pattern introductions.

2026-04-30 11:12:07 -07:00

analysis

docs: PR discussion analysis — how new patterns are debated and landed

2026-04-30 11:12:07 -07:00

elixir

docs: Elixir patterns vs official guidelines with code examples + hypotheses

2026-04-30 07:58:31 -07:00

docs: enhance Go divergence analysis with code examples + hypotheses

2026-04-30 07:57:37 -07:00

README.md

docs: Go patterns vs official guidelines divergence analysis

2026-04-30 07:50:32 -07:00

README.md

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	Effective Go, Code Review Comments, Google Style	go/
Elixir	rodin/elixir-patterns	CONTRIBUTING.md, Style Guide, HexDocs	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.