docs update (#344)

## Why

readme is out of date

## What changed

update readme, some casing consistency, more examples

## Versioning

- [ ] Breaking protocol change
- [ ] Breaking ts/js API change

<!-- Kind reminder to add tests and updated documentation if needed -->

---------

Co-authored-by: Faris Masad <[email protected]>

Author: jackyzha0