updates to internals doc