Better docs for resources API (fixes #73)