This class is pretty sparse on doc blocks in general. Before we merge this it would be good to flesh them out a bit.