Versionierung

Konzept

Versionierung macht Änderungen planbar. Eine Versionsnummer allein ersetzt jedoch keine klare Beschreibung der tatsächlichen Kompatibilität.

Grundsätze

• Inkompatible Vertragsänderungen erfolgen nicht stillschweigend.
• Erweiterungen verändern bestehende Bedeutung nicht rückwirkend.
• Veraltete Funktionen werden gekennzeichnet und erhalten einen nachvollziehbaren Übergang.
• API-Referenz, Beispiele und Änderungsprotokoll werden gemeinsam aktualisiert.
• Produktversionen und API-Vertragsversionen können unterschiedliche Lebenszyklen besitzen.

Status vor Versionsschema

Das verbindliche Versionsschema der vier zentralen APIs ist noch nicht freigegeben. Bis dahin dokumentieren diese Seiten Zielarchitektur und Status, aber keine behauptete API-Kompatibilität.