resource-discovery documentation and fixes