I guess the problem is that it's not discoverable. 

I think you are absolutely right. While the reflection is available (and the documentation, in general, is not at all bad), discoverability is still weak.