Adding docs to the repo instead of managing separately.

Initial commit, the proposal isn't quite finished yet.
It was only a rough draft before, anyway.
Finished writing draft of proposal.
Merge branch 'master' into ios