From 8ab02d94dd24c57d06f9c4bdde274ea9551e232b Mon Sep 17 00:00:00 2001 From: "Henry H. Andrews" Date: Sun, 26 May 2024 13:29:35 -0700 Subject: [PATCH 1/2] Resolution of relative URLs in CommonMark text (3.0.4) Note that they are resolved in their rendered context. --- versions/3.0.4.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/versions/3.0.4.md b/versions/3.0.4.md index 12b2375a79..d79f7dd90c 100644 --- a/versions/3.0.4.md +++ b/versions/3.0.4.md @@ -212,6 +212,8 @@ Relative references are resolved using the URLs defined in the [`Server Object`] Relative references used in `$ref` are processed as per [JSON Reference](https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03), using the URL of the current document as the base URI. See also the [Reference Object](#referenceObject). +Relative references in CommonMark hyperlinks are resolved in their rendered context, which might differ greatly from the context of the API description. + ### Schema In the following description, if a field is not explicitly **REQUIRED** or described with a MUST or SHALL, it can be considered OPTIONAL. From 2f7def536f30545516952f8c63c42eb36cc2f03b Mon Sep 17 00:00:00 2001 From: Henry Andrews Date: Mon, 27 May 2024 08:27:08 -0700 Subject: [PATCH 2/2] wording suggestion (review feedback) Co-authored-by: Ralf Handl --- versions/3.0.4.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/versions/3.0.4.md b/versions/3.0.4.md index d79f7dd90c..5a035a9e1e 100644 --- a/versions/3.0.4.md +++ b/versions/3.0.4.md @@ -212,7 +212,7 @@ Relative references are resolved using the URLs defined in the [`Server Object`] Relative references used in `$ref` are processed as per [JSON Reference](https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03), using the URL of the current document as the base URI. See also the [Reference Object](#referenceObject). -Relative references in CommonMark hyperlinks are resolved in their rendered context, which might differ greatly from the context of the API description. +Relative references in CommonMark hyperlinks are resolved in their rendered context, which might differ from the context of the API description. ### Schema