performing changes to guarantee that the project is fully functional
including new methos on README and cleaning up the sample code