doc : rebase

closes #2733

My writing probably needs a lot of editing.
We should probably add the acronym (PR). It isn't defined anywhere, and is github jargon.