deep update documentation for internal previewing