documented internals