physics doc updates