Updating docs to reflect current understanding