DOC: add some comments to test
DOC: add some comments to test

Explain the strange things being done.

sameera2004/bluesky,sameera2004/bluesky,dchabot/bluesky,klauer/bluesky,klauer/bluesky,ericdill/bluesky,dchabot/bluesky,ericdill/bluesky