clarifying comments more and testing issue tracking closes #8