added docs, see https://github.com/phetsims/axon/issues/15