DOCUMENTATION: Added/cleaned up the readme file

Added a new section 'common use cases' since I
get that question a lot.