Ahodges/doc/doc1117

@mulby , @shnayder , @WatsonEmily , @mhoeber , @catong , @srpearce , @stroilova , @dsjen please review. I do not yet have images to illustrate my examples, but otherwise ready.
good to know. Not sure yet how this will change once I have an actual image to use and describe though