update docs for working with remotes