adding desc to variables in codebook and updating assumptions in readme