README.md: Add documentation section with link to pyramid.path docs
README.md: Add some examples of usage