doc : rebase

closes #2733

My writing probably needs a lot of editing.
I would rename github to origin: it is more standard.