adding some documentation strings to Resources
adding a requestFactory so we can replace repeated entries of / in a url with a single / (fixes #28)