Reorganised documentation, configured pylint and addressed some warnings (current rating 9.89)