update the codebook and readme