more clarity in README and CodeBook