Improve README

[matthewsanetra]

It would be nice to have a README just outlining what this library is about, example usage, etc.

[matthewsanetra]

A README has been added in a recent PR but leaving this issue open as it can be improved (when we have the time ofc).

[thecsw]

readme can definitely be improved (and probably should be)!

it would also be nice to have all the goreportcard badges, go.dev links, etc and examples