major physics documentation update