From 139c087bd7d59bae10595e999fa5d003ba89e471 Mon Sep 17 00:00:00 2001
From: Abdessamad Derraz <3028866+Abdess@users.noreply.github.com>
Date: Wed, 11 Nov 2026 17:43:21 +0100
Subject: [PATCH] docs: describe the offered_boards fields

---
 schemas/install-manifest.schema.json | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/schemas/install-manifest.schema.json b/schemas/install-manifest.schema.json
index fb059c527..7ec7a91d3 100644
--- a/schemas/install-manifest.schema.json
+++ b/schemas/install-manifest.schema.json
@@ -152,9 +152,17 @@
           "additionalProperties": false,
           "required": ["root", "folder", "boards"],
           "properties": {
-            "root": {"enum": ["roms", "install"]},
-            "folder": {"type": "string", "minLength": 1},
+            "root": {
+              "description": "What the folder is relative to: the roms root of the platform, or the install tree.",
+              "enum": ["roms", "install"]
+            },
+            "folder": {
+              "description": "The folder the core is offered for, below that root.",
+              "type": "string",
+              "minLength": 1
+            },
             "boards": {
+              "description": "The boards, and their aliases, on which the folder offers the core.",
               "type": "array",
               "items": {"type": "string", "minLength": 1},
               "uniqueItems": true