interledger / open-payments

Protocol to setup payments between entities on the Web based on GNAP
https://openpayments.dev
Apache License 2.0
203 stars 34 forks source link

Add API versioning #380

Open sabineschaller opened 12 months ago

sabineschaller commented 12 months ago

For the OpenAPI schemas, we need to add versioning just like we had it on readme.

We want to add a dropdown to select the API version. It can be parsed from the yaml file. Additionally, we need to always show what's on main as the "version in development" (somebody find a better term for that).

huijing commented 11 months ago

Threads to follow:

sabineschaller commented 11 months ago

We decided to only have 2 versions. A stable one and a latest one which we can make changes to.

melissahenderson commented 2 months ago

Considering the age of this issue, we will need to discuss whether this is still something we want to do.

melissahenderson commented 3 weeks ago

@sabineschaller Is this something we should proceed with? Should the user docs only display the stable version, or do we want to make both versions available?