README update and codebook