codebook and readme update