README & code comments updates