This syntax is for adding an anchor?

Do we want to add a section about rebasing a pull-request on the top of master? (going via git remote -v and git remote add if needed then just git pull --rebase upstream master or so)

Ok I saw the ref so I think I figured it out :)

This looks great to me, I have a question and the only reason I'm not merging it right away is to allow you to reply to that question and save you from opening a new PR just for that section (if we choose to add it :)).

Indeed. The `:ref:configure-local-git``` then expands to the title.

I considered it. I wasn't sure if it would be useful or confusing to a new-comer so I left it out. It might not be bad to add an "Advanced" section, or maybe link to the Pro Git docs with various tips.

Either way works for me, do we want to do this in this PR or in another one?

(If we do this in another PR, we'll still need to rebase and fix this one :))

Okay, I added a brief paragraph on rebasing in the Pull Request guide that points to the rebasing documentation.

Many many thanks man, this looks great! :)

I think the word upstream can be deleted here.