added notes on most pages in the code