add calculation docs