[not ready] Docs updates

about to ping a bunch of people about TODOs here, be ready
@ansis I assume this is
-x = left
-y = up
-- confirm?