The v2.17.0 work left long prose comments explaining rationale that either repeats docs/ARCHITECTURE.md or restates the line below it. Cut ~520 comment lines across 54 files, keeping the short "why" notes for provider quirks and non-obvious flow behaviour.