wrote readme.MD, documentation, codebook; updated comments and variable names for clarity.