Revise heroku deployment doc.

Now it is a bit clearer and covers adding the remote as well as
uploading your SSH key to heroku (which did not happen automatically for
me).