Resolving Reference Object

[gcatanese]

The Reference Object section suggests to see the rules for resolving Relative References from the OpenAPI Specification. However, OpenAPI relative references are resolved using the ServerObject as a Base URL.

I think this section might need some clarity:

• use relative references from within the Workflow Specification file?
• use relative references within the SourceDescriptions?
• respect absolute URLs to refer to external resources?

[handrews]

@gcatanese I see the problem. Short version: Follow RFC 3986 and use the retrieval URI of the document as the base URI.

@frankkilcommins that section needs to reference the "Relative References in URIs" section, which applies to $ref. The "Relative References in URLs" section apples to Server URLs. I've filed OAI/OpenAPI-Specification#3545 to clarify this in OAS 3.1.1.

[handrews]

Actually, I think this is even simpler- the fragment syntax for the reference link changed, so it was dropping you in the wrong place in the OAS 3.1 spec. it was actually referencing the correct section. PR #146 should fix it.