<blockquote>
<p>The next version of the files can be <code>0.7</code> or anything else we like, sometimes new API versions will mean new file versions, sometimes not</p>
</blockquote>
<p>I'd like to check what you're proposing here. For example, lets say in the next version of the API, the nodes/ways/relations output is the same, but the format of the notes output is different[1]. Are you proposing</p>
<p>a) all endpoints should continue to output <code>version=0.6</code><br>
b) nodes/ways/relations should output <code>version=0.6</code> but notes should output <code>version=0.7</code><br>
c) something else?</p>
<p>Secondly, what if we introduce a new OSM document in the API? Until now, we've just used the existing number. For example, if we add a <diary_entry> API[2]. What number would that then output? Do you think it would be best to</p>
<p>a) start again from 0.1 for fresh OSM document types<br>
b) start from the lowest existing number in use<br>
c) start from the highest existing number in use<br>
d) something else?</p>
<p>[1] This is a genuine plan of mine, to make notes have a description instead of a special first comment, so I'm not making a strawman<br>
[2] Also something I genuinely want to add, but it's not dependent on having a new API version so could come before or after these changes.</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=AAK2OLK52HGMBWVPH2GZWTDQRFODJA5CNFSM4IOIASA2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOECTUI2Q#issuecomment-547832938">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/AAK2OLOHPBFBOEFVNZ6QBVTQRFODJANCNFSM4IOIASAQ">unsubscribe</a>.<img src="https://github.com/notifications/beacon/AAK2OLNFR772JHRELYH3DM3QRFODJA5CNFSM4IOIASA2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOECTUI2Q.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=AAK2OLK52HGMBWVPH2GZWTDQRFODJA5CNFSM4IOIASA2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOECTUI2Q#issuecomment-547832938",
"url": "https://github.com/openstreetmap/openstreetmap-website/pull/2353?email_source=notifications\u0026email_token=AAK2OLK52HGMBWVPH2GZWTDQRFODJA5CNFSM4IOIASA2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOECTUI2Q#issuecomment-547832938",
"name": "View Pull Request"
},
"description": "View this Pull Request on GitHub",
"publisher": {
"@type": "Organization",
"name": "GitHub",
"url": "https://github.com"
}
}
]</script>