updated comments on a couple shared examples
first set of updates for new display_type values and some refactoring of shared examples