documentation for codebook functionality