Improve support for custom finders

In bpo-38594, Gregory describes some issues with the documentation as well as asks for additional documentation to help a custom finder provide metadata.