updates readme, adds comments