more documentation (wip)