more updates on readme, enhanced tests and fixed bugs