[AOB-25] update readme

- [x] Some needed work
- [x]  some more needed work