update the readme with usage examples. closes #1