Adds README with useful information

README.markdown based on @flavioamieiro's draft
Removes unused module imports
Adds docstrings to pyquality.main's functions
Adds basic tests
Adds a TODO to pyquality.main.analyse_repository