first version of the completed writeup

still needs proofing and some tweaks.