address TODOs for https://github.com/phetsims/scenery-phet/issues/762 by adding documentation
address TODOs for https://github.com/phetsims/scenery-phet/issues/762 by adding documentation

phetsims/scenery-phet,phetsims/scenery-phet,phetsims/scenery-phet