From 594e31cd6ab8e4e60cd9d17e9e6c38048f464a84 Mon Sep 17 00:00:00 2001
From: Abdessamad Derraz <3028866+Abdess@users.noreply.github.com>
Date: Mon, 9 Nov 2026 23:01:22 +0100
Subject: [PATCH] docs: describe the outer root fields

roms_directory, emulators_directory and configs_directory described
themselves but not their fields, which the data page lists.
---
 schemas/install-manifest.schema.json | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/schemas/install-manifest.schema.json b/schemas/install-manifest.schema.json
index 9c3da6fe5..ea313b6b8 100644
--- a/schemas/install-manifest.schema.json
+++ b/schemas/install-manifest.schema.json
@@ -540,11 +540,13 @@
       ],
       "properties": {
         "bios_folder": {
+          "description": "Name of the BIOS folder from_bios starts from, the platform's base_destination.",
           "type": "string",
           "minLength": 1,
           "pattern": "^[^/\\\\]+$"
         },
         "from_bios": {
+          "description": "The roms root relative to that BIOS folder.",
           "type": "string",
           "pattern": "^(\\.|\\.\\.(/\\.\\.)?(/[^/\\\\:.][^/\\\\:]*)*)$",
           "maxLength": 1024
@@ -563,11 +565,13 @@
       ],
       "properties": {
         "bios_folder": {
+          "description": "Name of the BIOS folder; the other paths are relative to the folder holding it.",
           "type": "string",
           "minLength": 1,
           "pattern": "^[^/\\\\]+$"
         },
         "searched": {
+          "description": "The places the launcher tries for an emulator key, in order, {key} standing for it.",
           "type": "array",
           "minItems": 1,
           "items": {
@@ -576,10 +580,12 @@
           }
         },
         "default": {
+          "description": "The place the installer creates when none of searched exists.",
           "type": "string",
           "pattern": "\\{key\\}"
         },
         "config": {
+          "description": "The launcher's key=value file, a key of which moves the folder.",
           "type": "string",
           "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
         }
@@ -595,11 +601,13 @@
       ],
       "properties": {
         "bios_folder": {
+          "description": "Name of the BIOS folder from_bios starts from, the platform's base_destination.",
           "type": "string",
           "minLength": 1,
           "pattern": "^[^/\\\\]+$"
         },
         "from_bios": {
+          "description": "The configs folder relative to that BIOS folder.",
           "type": "string",
           "pattern": "^(\\.|\\.\\.(/\\.\\.)?(/[^/\\\\:.][^/\\\\:]*)*)$",
           "maxLength": 1024