Improve documentation

New issue to improve documentation and commenting for Oli/Naomi offboarding