readme: add docs

Continued from #2

cc @rlidwka
I don't think this example matches the section?