[not ready] Docs updates

about to ping a bunch of people about TODOs here, be ready
It's probably clear enough, but something short might not hurt.