Updated comments and notes

Updated comments, docstrings and notes on each of the files used in the first module for future reference.