several updates/clarifications to readme and codebook