add some more comments throughout the code
7 files changed