add some text to docs per dreid's suggestion