added doc, throw error correctly, formatting, add todo, https://github.com/phetsims/chipper/issues/776
added doc, throw error correctly, formatting, add todo, https://github.com/phetsims/chipper/issues/776

phetsims/chipper,phetsims/chipper,phetsims/chipper