From 568cab71ef7eb282101e6d9a1aad5215bc46e5ab Mon Sep 17 00:00:00 2001
From: Ralf Handl <ralf.handl@gmail.com>
Date: Fri, 7 Nov 2025 13:37:45 +0100
Subject: [PATCH 1/2] Register x-oai-traits

---
 _includes/extension-entry.md          |  2 +-
 registries/_extension/x-oai-traits.md | 22 ++++++++++++++++++++++
 2 files changed, 23 insertions(+), 1 deletion(-)
 create mode 100644 registries/_extension/x-oai-traits.md

diff --git a/_includes/extension-entry.md b/_includes/extension-entry.md
index e1028fb..2696674 100644
--- a/_includes/extension-entry.md
+++ b/_includes/extension-entry.md
@@ -8,7 +8,7 @@
 ### Schema
 
 ```yaml
-{{page.schema}}
+{{page.schema|jsonify}}
 ```
 
 ### Example
diff --git a/registries/_extension/x-oai-traits.md b/registries/_extension/x-oai-traits.md
new file mode 100644
index 0000000..cca0666
--- /dev/null
+++ b/registries/_extension/x-oai-traits.md
@@ -0,0 +1,22 @@
+---
+owner: ralfhandl
+issue:
+description: Identify in an OpenAPI Description where Overlay updates should be applied.
+schema:
+  type: array
+  items:
+    type: string
+layout: default
+---
+
+{% capture summary %}
+The `x-oai-traits` extension is used identify places in an OpenAPI Description where Overlay updates should be applied. Its value is an array of strings, each string identifying a feature that an Overlay should apply.
+{% endcapture %}
+
+{% capture example %}
+See:
+
+* [Traits Example in Overlay Specification](https://spec.openapis.org/overlay/v1.0.0.html#traits-example)
+{% endcapture %}
+
+{% include extension-entry.md summary=summary example=example %}  

From 3f31c23fc8601408a464ff815c3d05b79a178fdd Mon Sep 17 00:00:00 2001
From: Ralf Handl <ralf.handl@gmail.com>
Date: Mon, 10 Nov 2025 14:11:26 +0100
Subject: [PATCH 2/2] Update x-oai-traits.md

Co-authored-by: Lorna Jane Mitchell <lorna@lornajane.net>
---
 registries/_extension/x-oai-traits.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/registries/_extension/x-oai-traits.md b/registries/_extension/x-oai-traits.md
index cca0666..e55607d 100644
--- a/registries/_extension/x-oai-traits.md
+++ b/registries/_extension/x-oai-traits.md
@@ -10,7 +10,7 @@ layout: default
 ---
 
 {% capture summary %}
-The `x-oai-traits` extension is used identify places in an OpenAPI Description where Overlay updates should be applied. Its value is an array of strings, each string identifying a feature that an Overlay should apply.
+The `x-oai-traits` extension is used to identify places in an OpenAPI Description where Overlay updates should be applied. Its value is an array of strings, each string identifying a feature that an Overlay should apply.
 {% endcapture %}
 
 {% capture example %}