<blockquote>
<p>you still need some way of determining what version you -exactly- have in front of you</p>
</blockquote>
<p>So let's take a feature like "notes" which was added in during the 0.6 era. I think your use-case is along the lines of "I'm an editor developer, and I want to know if notes are available on this endpoint, which might be osm.org or might be some other deployment that is running an older codebase that doesn't have notes yet, so that I can show/hide the relevant UI". If I've misunderstood let me know.</p>
<p>You're suggesting that we should therefore introduce the minor API version in responses. I suspect you don't need to know the minor version in every response (e.g. <code>/api/X/ways/1</code> -> <code><osm version="7.9" ...</code>), but you need a response from the server to let you know what the server is capable of doing. So maybe just in the <code>/api/X/capabilities</code> call? And then you can show/hide notes functionality depending on whether X.Y is greater than the version number where notes were introduced.</p>
<p>But then, why bother with lists of features and their corresponding minor version numbers? That's a bit indirect, since we could just put the additional features into the <code>capabilities</code> response e.g. <code><feature name="notes" /></code> to indicate that the endpoint now supports notes. Would that work?</p>

<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">—<br />You are receiving this because you are subscribed to this thread.<br />Reply to this email directly, <a href="https://github.com/openstreetmap/openstreetmap-website/pull/2353?email_source=notifications&email_token=AAK2OLLSVI4QA6KSOW6V74LQHEKHVA5CNFSM4IOIASA2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD5RSK2I#issuecomment-526591337">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/AAK2OLISNMU4KQOR2MGD2UDQHEKHVANCNFSM4IOIASAQ">mute the thread</a>.<img src="https://github.com/notifications/beacon/AAK2OLPFP7KRLVGDBHDR2OLQHEKHVA5CNFSM4IOIASA2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD5RSK2I.gif" height="1" width="1" alt="" /></p>
<script type="application/ld+json">[
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "ViewAction",
"target": "https://github.com/openstreetmap/openstreetmap-website/pull/2353?email_source=notifications\u0026email_token=AAK2OLLSVI4QA6KSOW6V74LQHEKHVA5CNFSM4IOIASA2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD5RSK2I#issuecomment-526591337",
"url": "https://github.com/openstreetmap/openstreetmap-website/pull/2353?email_source=notifications\u0026email_token=AAK2OLLSVI4QA6KSOW6V74LQHEKHVA5CNFSM4IOIASA2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD5RSK2I#issuecomment-526591337",
"name": "View Pull Request"
},
"description": "View this Pull Request on GitHub",
"publisher": {
"@type": "Organization",
"name": "GitHub",
"url": "https://github.com"
}
}
]</script>