add comments, remove unused code

[mhoughton26]

elaborates on why previous changes were made to make the code more understandable and removes obsolete code because it is not needed