codebook, readme changes