[WIP] Refactor docs

Fix #94.
created #117, lets see. i think we should merge now, and then clean that bit up.

if you agree, can you squash and merge?