Naar de inhoud

Incompatibele wijziging

Een wijziging waardoor eerder ondersteunde afnemers of toepassingen niet meer volgens afspraak functioneren.

Ook bekend alsBreaking Change
Softwarearchitectuur

Een bestaande toezegging verandert onverenigbaar

Een incompatibele wijziging verandert een ondersteunde overeenkomst zodat bestaande afnemers zich moeten aanpassen of afgesproken gedrag verliezen. Dat kan gegevensformaat, verplichte invoer of betekenis van een resultaat raken.

In een fictief voorbeeld verwijdert een opdracht-API het eerder toegezegde veld orderId. Een rapport dat daarop steunt, kan de opdracht niet meer identificeren. Een interne naamswijziging zonder effect op de publieke overeenkomst is niet zo’n breuk. Controleer getroffen afnemers, overgang en communicatie vóór vrijgave. Een nieuw versienummer past de afnemer niet vanzelf aan. Zelfs een ongewijzigd antwoordformaat kan een onverenigbare inhoudelijke gedragswijziging bevatten.

Bronnen