resubmitted wrong version of this doc in PR #180. this is the right one,...

... i swear