doc : rebase

closes #2733

My writing probably needs a lot of editing.
This sentence ain't proper english/american :)
I think there is a verb missing.