further documentation updates
cleanup debug messages