readme: add docs

Continued from #2

cc @rlidwka
You cannot establish a `h3` when no `h2` even exists; please make these make sense from a hierarchy instead of how GitHub happens to make them look.