update phd documentation and clean-up