A lot of change here.
Big update on the readme file. All use cases are now documented