Make PathItem a referenceable object about openapi.net

[PerthCharern]

Could you remind me where PathItem is referenced? Are we talking about the PathItem in the Callback object?

[darrelmiller]

@PerthCharern It is the first fixed field in a PathItem object https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#pathItemObject

[PerthCharern]

What do you think about the Operation object? Potentially, it can also be a referenceable object?

https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#linkObject

The link object can refer to the Operation by its id.

[PerthCharern]

And yes, PathItem should also be handled.

[darrelmiller]

@PerthCharern That's an interesting thought. It certainly would help to prevent breakage when people rename Ids. Although we would need to decide what to do about the OperationRef vs OperationId situation. It also adds to my questions about what does it mean if you edit an instance that is an external reference.