openservicebrokerapi / servicebroker

Open Service Broker API Specification
https://openservicebrokerapi.org/
Apache License 2.0
1.19k stars 434 forks source link

OSBAPI Project Feedback #322

Closed avade closed 5 years ago

avade commented 7 years ago

Last week we had three interesting bits of feedback from ISV's integrating with the service broker API:

  1. It wasn't obvious that their existing service brokers would work with the OSBAPI specification
  2. They thought the API was developer-facing and wanted to expose service brokers directly to developers via a CLI
  3. They thought the project provided an API server and didn't realise it was a specification only
  4. From the website, it was difficult to find the specification

I suggest that we do the following:

  1. Modify the landing page at https://openservicebrokerapi.org to clarify the above points
  2. Make it easier to find the spec from the landing page
mattmcneeney commented 7 years ago

Agreed!

duglin commented 7 years ago

Clarity is good - go for it.

avade commented 7 years ago

As per our call, I will start to draft changes and share with the group in this issue.

leonwanghui commented 6 years ago

Hi, sorry to turn out this out-of-date issue, but I'm quite interested at this collaborative meeting, so is this call public and periodically? Thanks!

MHBauer commented 6 years ago

@leonwanghui call details available here https://github.com/openservicebrokerapi/servicebroker/wiki/Weekly-Call

leonwanghui commented 6 years ago

@MHBauer Got it, same one with what I known...

mattmcneeney commented 5 years ago

Closing as this information is now available in the readme.