misc comments
many more details added to README