update to README and personal documentation