The first comment calls the code below a "misconfiguration" and the next comment tells the user what they must do with the code below that. I don't see an ambiguity here.

Pointing users at the API or provider metadata classes would be sending them all over the place and causing greater confusion. The metadata classes are an implementation detail that should be hidden from users.

I think this points to a hole in our current docs. We have no *single* page that lists all APIs/Providers.