Stabilitätsgarantien sollten durch eine einfache API-Versionierung angegangen werden.
In diesem Thema geht es nicht darum, wo die Dokumentation lebt – es geht darum, wie die API dokumentiert ist. Was fehlt, ist ein standardisiertes, maschinenlesbares Format wie OpenAPI.
Diese Abwesenheit, zusammen mit dem Mangel an Versionierung, macht die Integrationsarbeit schwieriger und fragiler, als sie sein sollte. Selbst ein grundlegendes OpenAPI-Schema für die dokumentierten Endpunkte wäre sehr hilfreich.