continuing work on internals documentation