Avoiding readlines()
Updating comments
Adding raises section
Adding one line docstrings
Changing order of See also and parameters
Adding documentation