From 403c402efe4998b4ed7af3c059666ff366dd8c5b Mon Sep 17 00:00:00 2001 From: apidesigner Date: Tue, 31 Jan 2017 11:11:27 +0000 Subject: [PATCH] Updates core-principles/versioning.md Auto commit by GitBook Editor --- core-principles/versioning.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/core-principles/versioning.md b/core-principles/versioning.md index 40fd4cd..4d72799 100644 --- a/core-principles/versioning.md +++ b/core-principles/versioning.md @@ -15,10 +15,10 @@ Any change to: MUST follow the [Rules for Extending](core-principles/rules-for-extending.md). ## No URI Versioning -A change SHALL NOT affect **existing** resource identifiers (name / URI). +A change SHALL NOT affect **existing** resource identifiers (name / URI). Resource identifier MUST NOT contain semantic versioning to convey a version of resource or its representation format. #### Example -Adding a new action to existing resource with identifier `/greeting` doesn't change its identifier to `/v2/greeting`. +Adding a new action to existing resource with identifier `/greeting` doesn't change its identifier to `/v2/greeting` (or `/greeting-with-new-action` etc.). ## Backward-incompatible Change A change to _resource identifier_, _resource metadata_, _resource actions_ and _resource relations_, that can't follow the [Rules for Extending](core-principles/rules-for-extending.md) MUST result into a **new resource variant**. Existing resource variant MUST be preserved.