wip: documentation stubs prior to refactoring

the documentation additions are only stubs and I shall clean them up in a couple of days