first codebook + updated readme