add text description for resource, fix corner case bug