closes #231 documents logger functions