further internals documentation