document slit angle calculation in docstrings and comments

Double check the in-code documentation with the angle code, seems outdated