dom docs

@jbruton review