Updated README documentation and additional code comments