add introductory paragraph, adapted from docs.md

[jugglinmike]

See my comment here. I want to help avoid confusion in the future, though, so I made an alternate proposal with gh-20. Mind reviewing that for me?

[waldyrious]

update: discussion has moved to #20