updating documentation
documentation!
	- Updating README.md file with actual useful information
	- created a 3rd example (a bit more convoluted than the original 2)
fixing a bug caused by a type-o
Merge branch 'documentation'

* documentation:
  documentation! 	- Updating README.md file with actual useful information 	- created a 3rd example (a bit more convoluted than the original 2)
  updating documentation