added output and udpated README markdown file
update comments for clarity