Update the calculation docs with some more current thinking.