Do a readme review and make sure it has all the latest goodies and most relevant examples

[philippedistributive]

Describe your feature request here.

@philippedistributive had a recent pass, let's see what @wesgarland can add

Code example

No response