Some documentation

I am Resubmitting some documentation because the last attempt failed due to merge conflicts with sp's branch and my branching confusions resulted in a lot of loss :sob: This one seems to be clean. Please check and merge.