Big readme update

Examples, usage, python doc links