Adding Api docs for mapResources()

Hi again, here's my concept documentation for the mapResources() feature. 

I am no markdown hero so let me know or feel free to change it as you see fit.