[WIP] Refactor docs

Fix #94.
the first sentence is a general intro and does not belong here.