[openstreetmap/openstreetmap-website] Supporting multiple API versions (#2353)

Andy Allan notifications at github.com
Wed Dec 4 11:20:44 UTC 2019


So it's clear that this PR has got stuck, and that I need to find some way to move this forward. I've been trying to figure out what that would be for the last few weeks.

This PR was (and still is) just a tiny first step towards general support for multiple versions, never mind any decisions as to how the versions will differ from each other when finally deployed. However, it's reasonable that people want to pitch in with their thoughts on the wider concepts around the API versions. Two recurring themes come up:

* The topic of what the next version number in the url should be (e.g. `0.7` vs `7` and related concepts of semantic versioning for the API)
* The topic of what version number(s) should be in the responses

The latter is particularly what has got this PR stuck. We can't have a fully informed decision on what number(s) to put into the responses until we see more examples of what's actually going to change. But we can't code any of the specific changes until I have implemented general support for multiple versions. And this is just the first in ~20 PRs that will be needed for the general support, never mind the ~?? PRs which will be about actually changing any API responses.

So my proposal is:

* To create a new issue discussing what the next version number in the urls should be
* To create a new issue for continuing the discussion on version numbers in the responses
* Meanwhile, to open a fresh PR to replace this one, with conflicts resolved
* To continue to work on the general support for multiple versions
* To then work on specific changes to the API

I think this will allow us to unblock the general development work while the wider issues are discussed more fully.


-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/openstreetmap/openstreetmap-website/pull/2353#issuecomment-561601385
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstreetmap.org/pipermail/rails-dev/attachments/20191204/d683e272/attachment.html>


More information about the rails-dev mailing list