improved documentation of resource type hierarchy usage