diff --git a/versions/3.0.md b/versions/3.0.md index 2c9c85c356..4a286cf6e4 100644 --- a/versions/3.0.md +++ b/versions/3.0.md @@ -2046,15 +2046,15 @@ ColorSelection: Would produce three links with the `colorName` of `red`, `green`, and `blue`: -As with all links, it is at the clients' discretion to follow them, neither -permissions nor the ability to make a successful call to that link is guaranteed +Clients follow all links, including these, at their own discretion. Neither +permissions, nor the capability to make a successful call to that link, is guaranteed solely by the existence of a relationship. ##### Example The example below shows how relationships in the BitBucket API can be represented -with the link schema. This example uses `operationId` values to link responses to +by the link schema. This example uses `operationId` values to link responses to possible operations. ```yaml @@ -2280,7 +2280,7 @@ components: href: 'https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{$response.body#/username}' ``` -Note that in the use of `operationRef`, the _escaped forward-slash_ is necessary when +Prefixing `operationRef` using the _escaped forward-slash_ is necessary when using JSON references. #### Header Object