codebook and readme updates