Introduce credentials
Remote: add documentation for credentials
Update clone_repository's docs

It claims you need to checkout a branch after clone, which is not the
case currently (the clone function will do it for you).

While here, format the docstring for sphinx to make it pretty.
Add credentials support to clone_repository()
wip