Remove "adding a service broker to the platform" section?

openservicebrokerapi / servicebroker

Open Service Broker API Specification

https://openservicebrokerapi.org/

Apache License 2.0

1.19k stars 434 forks source link

Remove "adding a service broker to the platform" section? #576

Closed mattmcneeney closed 6 years ago

mattmcneeney commented 6 years ago

The text in this section seems irrelevant and describes platform-specific behaviour:

After implementing the first endpoint GET /v2/catalog documented above, the Service Broker will need to be registered with your Platform to make your services and plans available to end users.

Should we remove it?

duglin commented 6 years ago

From a pure spec perspective I agree since it has no normative language in it. It feels like it should really be in some kind of "primer" doc to help explain the overall purpose/flow of the spec. But, I don't have a strong opinion on it either way. I'm ok if you want to remove it.