adding comments and database description

updated readme and added code comments