Merge pull request #1 from pecharmin/master

Notes to README
Merge pull request #2 from pecharmin/master

Improved exception handling; Return code; Test cases
Improve variable names
Improve code formatting
Disable IntelliJ inspections were appropriate
Add _ to names where appropriate