where should new pages for the docs site go? on readme.com or in repo via PRs?

I'm pretty sure it would go in repo

Yeah, in-repo. What's the new page? We don't have precedent yet for creating a new page