update methods / physics / spec notes