split 1st paragraph, removed repeditive 'documentation'

ref #1

I remember an English teacher would red-mark my papers if I used the same word 3 times almost in a row ;).
Rebased
Merge branch 'tomByrer-patch-1'