[openstreetmap/openstreetmap-website] Use where instead of find to prevent 404 (b9c85c2)

Kamil Monicz notifications at github.com
Tue Aug 29 09:50:37 UTC 2023


@mmd-osm Thank you for your input. I've revised the text on the wiki as follows:

> Please note that this is NOT official documentation[[1]](https://wiki.openstreetmap.org/wiki/API_v0.6#cite_note-1). Every behavior described here is subject to change in the future.

This revision should more accurately reflect the current status. As this is the only API documentation available, it's crucial to inform developers about its unofficial nature and potential for change. This type of information might come as a surprise given the project's size, so it's better to be transparent about it.

> Don't get too much hooked up that there's no official documentation. That's ok, everyone knows it. It's been this way since the beginning, and unlikely to change anytime soon.

The landscape of the OSM project today differs from its state a decade ago. With more developers, including commercial ventures, relying on this project, having dependable documentation becomes critical. Once again, this appears to be a significant oversight.

Personally, the distinction between official and unofficial doesn't concern me greatly. What I care about the most is writing reliable software. If we're at the point where we decide to intentionally change tests and go against the only available documentation (the consensus), this is a major red flag for me.

-- 
Reply to this email directly or view it on GitHub:
https://github.com/openstreetmap/openstreetmap-website/commit/b9c85c269726faad3c2613b37f01683c8b59f5c6#commitcomment-125799901
You are receiving this because you are subscribed to this thread.

Message ID: <openstreetmap/openstreetmap-website/commit/b9c85c269726faad3c2613b37f01683c8b59f5c6/125799901 at github.com>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstreetmap.org/pipermail/rails-dev/attachments/20230829/2d6f8219/attachment.htm>


More information about the rails-dev mailing list