Readme updated

Changed methods return types and descriptions