diff --git a/evolution/uri-structure.md b/evolution/uri-structure.md index 2c85919..ec47f0e 100644 --- a/evolution/uri-structure.md +++ b/evolution/uri-structure.md @@ -2,8 +2,8 @@ URI is meant to express an **identity of an resource**. URI is an identifier and it **MUST NOT** convey any other information. -The API design process **SHOULD NOT** start with the design of URIs. Contrary, the URI **SHOULD** be amongst the last few things added to the API design. +The API design process **MUST NOT** start with the design of URIs. Contrary, the URI **SHOULD** be amongst the last few things added to the API design. -In adidas URIs are subject to [naming conventions](https://adidas-group.gitbooks.io/api-guidelines/content/evolution/naming-conventions.html). +At adidas, URIs are subject to [naming conventions](https://adidas-group.gitbooks.io/api-guidelines/content/evolution/naming-conventions.html). To read more about the problematics refer to [RFC 7320: URI Design and Ownership](https://tools.ietf.org/html/rfc7320).