Add docs

[arianitu]

Add documentation (including a static page) that explains how pkg/resource works. Ideally you get a full working example in the README.md as I find it quite annoying to leave github for docs.