Readme complete

  - README.md was created and completed
  - Updated some unit tests
  - Updated some documentation and code
  - Added examples