{"action":"created","issue":{"url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/1038","repository_url":"https://api.github.com/repos/OAI/OpenAPI-Specification","labels_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/1038/labels{/name}","comments_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/1038/comments","events_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/1038/events","html_url":"https://github.com/OAI/OpenAPI-Specification/issues/1038","id":221149054,"number":1038,"title":"Clarify or remove language about \"conflicts\" in Path Item Object $ref property","user":{"login":"tedepstein","id":692813,"avatar_url":"https://avatars3.githubusercontent.com/u/692813?v=3","gravatar_id":"","url":"https://api.github.com/users/tedepstein","html_url":"https://github.com/tedepstein","followers_url":"https://api.github.com/users/tedepstein/followers","following_url":"https://api.github.com/users/tedepstein/following{/other_user}","gists_url":"https://api.github.com/users/tedepstein/gists{/gist_id}","starred_url":"https://api.github.com/users/tedepstein/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tedepstein/subscriptions","organizations_url":"https://api.github.com/users/tedepstein/orgs","repos_url":"https://api.github.com/users/tedepstein/repos","events_url":"https://api.github.com/users/tedepstein/events{/privacy}","received_events_url":"https://api.github.com/users/tedepstein/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":5,"created_at":"2017-04-12T04:31:53Z","updated_at":"2017-04-20T12:27:27Z","closed_at":null,"body":"The [Path Item Object](https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc0/versions/3.0.md#user-content-pathItemObject) documentation for the `$ref` property says:\r\n \r\n> Allows for an external definition of this path item. The referenced structure MUST be in the format of a Path Item Object. If there are conflicts between the referenced definition and this Path Item's definition, the behavior is undefined.\r\n\r\nI don't understand what conflict could arise. I assume that the value of this `$ref` property is a JSON Reference, like all of the other `$ref` properties defined in the spec. In that case, `$ref` should not have any sibling properties, and if it did, those would be ignored according to the JSON Reference spec. \r\n\r\nSo, for consistency and clarity, can we remove this language? "},"comment":{"url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/comments/295717248","html_url":"https://github.com/OAI/OpenAPI-Specification/issues/1038#issuecomment-295717248","issue_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/1038","id":295717248,"user":{"login":"tedepstein","id":692813,"avatar_url":"https://avatars3.githubusercontent.com/u/692813?v=3","gravatar_id":"","url":"https://api.github.com/users/tedepstein","html_url":"https://github.com/tedepstein","followers_url":"https://api.github.com/users/tedepstein/followers","following_url":"https://api.github.com/users/tedepstein/following{/other_user}","gists_url":"https://api.github.com/users/tedepstein/gists{/gist_id}","starred_url":"https://api.github.com/users/tedepstein/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tedepstein/subscriptions","organizations_url":"https://api.github.com/users/tedepstein/orgs","repos_url":"https://api.github.com/users/tedepstein/repos","events_url":"https://api.github.com/users/tedepstein/events{/privacy}","received_events_url":"https://api.github.com/users/tedepstein/received_events","type":"User","site_admin":false},"created_at":"2017-04-20T12:27:27Z","updated_at":"2017-04-20T12:27:27Z","body":"I made a small correction to my earlier description, for clarity: \r\n\r\n...properties of the referrent (external path item) are supposed to be merged in with the referrer (inline path item)? So `/foo` containing `get` _and_ `$ref: \"FooPath.yaml#/paths/~1foo\"` can merge in  *`FooPath.yaml#/paths/~1foo` containing `patch`*, yielding a single `/foo` path with `get` and `patch` methods? \r\n\r\n(Emphasis added.)\r\n\r\n@webron , thanks for clarifying. I will give this some thought & respond later..."}}
{"actor":{"display_login":"tedepstein"}}