From 28b3d446286f9bb093201ed255b6d2ab2a41de2b Mon Sep 17 00:00:00 2001 From: Ethan Date: Mon, 16 Mar 2026 16:36:27 -0700 Subject: [PATCH] fix OAS.md Appedix F URI inconsistencies --- src/oas.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/oas.md b/src/oas.md index 59d17a2247..ad1c3c457c 100644 --- a/src/oas.md +++ b/src/oas.md @@ -5336,7 +5336,7 @@ components: content: application/json: schema: - $ref: "#/components/api/schemas/Foo" + $ref: "#/components/schemas/Foo" schemas: Foo: properties: @@ -5457,7 +5457,7 @@ components: ``` In this example, all of the `$self` and `$id` values are relative URI references consisting of an absolute path. -This allows the retrieval URI to set the host (and scheme), in this case `https://staging.example.com`, resulting in the first document's `$self` being `https://staging.example.com/openapi`, and the second document's `$self` being `https://staging.example.com/api/shared/foo`, with `$id` values of `https://staging.example.com/api/schemas/foo` and `https://staging.example.com/api/schemas/bar`. +This allows the retrieval URI to set the host (and scheme), in this case `https://staging.example.com`, resulting in the first document's `$self` being `https://staging.example.com/api/openapi`, and the second document's `$self` being `https://staging.example.com/api/shared/foo`, with `$id` values of `https://staging.example.com/api/schemas/foo` and `https://staging.example.com/api/schemas/bar`. Relative `$self` and `$id` values of this sort allow the same set of documents to work when deployed to other hosts, e.g. `https://example.com` (production) or `https://localhost:8080` (local development). ## Appendix G: Parsing and Resolution Guidance