readme: add docs

Continued from #2

cc @rlidwka
@dougwilson it appears to handle this correctly.