refactoring some method names and return types
README added