readme: add docs

Continued from #2

cc @rlidwka
Quite frankly I care much more about ease of reading.