Adds introduction, rewrites URL/REST guidance.

Fixes #7. Fixes #9. Fixes #10.