document the shorthand repo feature

noticed that theres a place in the `README.md` where all these things are documented.

adding it here.