MAINT: added comments for report function
MAINT: added comments for report function

Added comments for the report function, explaining why it is structured the
way that it is.

cmeeren/aacgmv2,cmeeren/aacgmv2,cmeeren/aacgmv2