From 5aa67086b58cbc2f080520cbb77930df1f41aa33 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Commaille?= <zecakeh@tedomum.fr>
Date: Fri, 29 Mar 2024 15:20:02 +0100
Subject: [PATCH] Document use of $ref to compose examples
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
---
 openapi_extensions.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/openapi_extensions.md b/openapi_extensions.md
index 15b93adc..8a7146a9 100644
--- a/openapi_extensions.md
+++ b/openapi_extensions.md
@@ -26,3 +26,8 @@ property, etc).
 
 A variation of the above: indicates changes to the associated parameter in
 particular Matrix specification versions.
+
+## Use of `$ref` inside examples
+
+Although the OpenAPI/JSON Schema specs only allow to use `$ref` to reference a
+whole example, we use it to compose examples from other examples.