Changed from: 'How Bad Am I, Actually? Building a Pickleball Rating System That Doesn't Lie'
New title: 'The Carry Problem: When Your Rating Doesn't Match Your Ego'
With subtitle: 'A Mathematically Principled Approach to Rating Pickleball Players
(And Finally Proving Whether Your Partner Is Holding You Back)'
RATIONALE:
- 'The Carry Problem' directly addresses v2's innovation (effective opponent formula)
- Funny and relatable without being mean-spirited
- Hooks both casual players and technical readers
- Self-deprecating sass matches the rec pickleball vibe
- More memorable than academic title
The rest of the document (intro, TL;DR, content) already had the right tone.
DOCUMENTATION ADDED:
1. docs/rating-system-v2.tex (681 lines, ~9,000 words)
- Complete technical report on system redesign
- Includes: introduction, mathematical foundation, v1 review
- Motivation for all 4 changes with detailed explanations
- Complete v2.0 formulas with clear notation
- Worked example: concrete doubles match (v1 vs v2)
- Discussion of advantages, edge cases, future work
- Professional typesetting for blog/website publication
- 36 subsections with table of contents
2. docs/README.md
- How to compile the LaTeX document
- File overview and contents summary
- Compilation instructions for macOS, Linux, Docker, Overleaf
- Publishing guidance (HTML conversion, blog extraction)
- Citation format for references
3. docs/FORMULAS.md
- Quick reference card for all formulas
- Match outcome calculation (singles & doubles)
- Effective opponent examples
- RD distribution formula with worked examples
- Expected point win probability table
- Parameter meanings and initial values
- Summary of v1 vs v2 changes
- FAQ section
STATUS: Ready for publication ✅
- LaTeX file is syntactically correct
- All formulas verified against code
- Example calculations match implementation
- Suitable for recreational audience + technical rigor
- Can be compiled to PDF or converted to HTML/blog format
- README.md: full project docs with features, API endpoints, Glicko-2 explanation
- main.rs: doc comments for all 18 HTTP handlers
- db/mod.rs: schema and migration documentation
- models/mod.rs: Player struct and Glicko-2 parameter docs
- Fixed route syntax (:id instead of {id}) for Axum 0.7 compatibility
