start some documentation

which then gives me an idea for refactoring the docs :)