[WG-UMA] Use OpenAPI JSON for Resource Registration?

This conversation today about whether to add "description" made me question if we have the right approach for resource registration. I opened this issue to track the idea for using the OpenApi JSON format (Swagger): https://github.com/KantaraInitiative/wg-uma/issues/288 Perhaps instead of creating a whole "registration" API, we should just be documenting how to make this information discoverable? As a point of reference, Google publishes the scopes for it's API's: http://gluu.co/google-scopes - Mike