wip: documentation stubs prior to refactoring