Improved clarification in readme and comments, changed order of parameters in constructor method and small fixes