update documentation regarding resource ids
update documentation regarding resource ids

Add information about the special handling of resource ids.

Closes #698

gnocchixyz/gnocchi,gnocchixyz/gnocchi,sileht/gnocchi,sileht/gnocchi