update readme and codebook