chore: standardize notes: to note: in file entries

240 file-level entries used notes: instead of the canonical note:
field. verify.py and cross_reference.py only read note:, so these
were silently ignored.

emulators/ardens.yml

@@ -48,7 +48,7 @@ platform_details:
         array: "ARDENS_BOOT_MENU_E2"
         size: 8548
         device: "Arduboy Mini"
-    notes: |
+    note: |
       All bootloaders are compiled from Intel HEX into C arrays at build
       time. The core selects the game or menu variant at reset depending
       on whether a flashcart image was loaded and the boot_to_menu config
@@ -60,7 +60,7 @@ platform_details:
     source_ref: "src/boot/boot_flashcart.c, src/absim_w25q128.hpp:14"
     array: "ARDENS_BOOT_FLASHCART"
     size: 1536
-    notes: |
+    note: |
       Empty flashcart header written to the first 1536 bytes of the
       W25Q128 flash image during initialization. This is not a BIOS
       file -- it is the default flash content the Arduboy FX expects

emulators/beetle_lynx.yml

@@ -32,4 +32,4 @@ files:
     size: 512
     crc32: "0d973c9d"
     source_ref: "libretro.cpp:191, rom.cpp:50-78, cart.cpp:67"
-    notes: "512-byte boot ROM. Core silently degrades without it but games will not run."
+    note: "512-byte boot ROM. Core silently degrades without it but games will not run."

emulators/beetle_psx.yml

@@ -85,7 +85,7 @@ files:
     mode: libretro
     source_ref: "libretro.cpp:190-195"
     aliases: ["PSXONPSP660.bin"]
-    notes: "override_bios=1. Falls back to region BIOS if not found."
+    note: "override_bios=1. Falls back to region BIOS if not found."
 
   - name: "ps1_rom.bin"
     description: "PS3 embedded PS1 BIOS (region-free override)"
@@ -98,4 +98,4 @@ files:
     mode: libretro
     source_ref: "libretro.cpp:198-203"
     aliases: ["PS1_ROM.bin"]
-    notes: "override_bios=2. Falls back to region BIOS if not found."
+    note: "override_bios=2. Falls back to region BIOS if not found."

emulators/bk.yml

@@ -140,7 +140,7 @@ files:
 platform_details:
   bios_mapping:
     source_ref: "libretro.c:718-760, boot.c:83-116"
-    notes: |
+    note: |
       ROM directory is {system_dir}/bk/ (libretro.c:724-726).
       Model selection via core option "bk_model" determines which ROMs are loaded.
       The core shuts down immediately if any required ROM for the selected model
@@ -148,7 +148,7 @@ platform_details:
 
   model_rom_map:
     source_ref: "libretro.c:734-756, boot.c:83-116"
-    notes: |
+    note: |
       BK-0010:            MONIT10.ROM + FOCAL10.ROM
       BK-0010.01:         MONIT10.ROM + BASIC10.ROM
       BK-0010.01 + FDD:   MONIT10.ROM + DISK_327.ROM
@@ -158,7 +158,7 @@ platform_details:
 
   rom_loading:
     source_ref: "libretro.c:1050-1107"
-    notes: |
+    note: |
       load_rom_file() first tries {romdir}/{filename} with original casing.
       If not found, retries with the filename converted to lowercase.
       Returns NULL and shuts down the core on failure.

emulators/blastem.yml

@@ -64,7 +64,7 @@ analysis:
     rom_size: 2048  # 2 KB
     config_path: "system\0tmss_path\0"
     source_ref: "genesis.c:1910"
-    notes: |
+    note: |
       TMSS ROM is loaded from tmss.md (configurable via system/tmss_path).
       Models with tmss=on: md1va6, md2va1, md2va2, md3va1, md3va2.
       Models with tmss=off: md1va0, md1va3 (default), teradrive.
@@ -73,10 +73,10 @@ analysis:
   sega_cd:
     supported: false
     source_ref: "system.c:16"
-    notes: "TODO comment only: 'Differentiate between vanilla Genesis and Sega CD/32X games'"
+    note: "TODO comment only: 'Differentiate between vanilla Genesis and Sega CD/32X games'"
 
   jaguar_bios:
     libretro_relevant: false
-    notes: |
+    note: |
       blastjag (jaguar.c) is a separate standalone binary, not compiled
       into the libretro core. Requires BIOS as first CLI argument.

emulators/cap32.yml

@@ -94,7 +94,7 @@ files:
 platform_details:
   bios_mapping:
     source_ref: "cap32/cap32.c:1072-1100, cap32/cap32.c:342-345"
-    notes: |
+    note: |
       All ROMs are embedded. emulator_select_ROM() copies the appropriate
       ROM array into the pbROM buffer based on CPC.model. No filesystem
       lookup occurs in the libretro port. The retro_system_bios_directory
@@ -103,7 +103,7 @@ platform_details:
 
   embedded_roms:
     source_ref: "cap32/rom/464.h, cap32/rom/6128.h, cap32/rom/amsdos.h, cap32/rom/6128p.h, cap32/rom/cpm.h"
-    notes: |
+    note: |
       5 ROM sets embedded as C arrays:
       OS_BASIC10 (32KB) - CPC 464/664 OS + BASIC 1.0
       OS_BASIC11 (32KB) - CPC 6128 OS + BASIC 1.1
@@ -113,7 +113,7 @@ platform_details:
 
   model_rom_map:
     source_ref: "cap32/cap32.c:1072-1100"
-    notes: |
+    note: |
       CPC 464:  OS_BASIC10 only (no disk support)
       CPC 664:  OS_BASIC10 + AMSDOS in ROM slot 7
       CPC 6128: OS_BASIC11 + AMSDOS in ROM slot 7

emulators/chimerasnes.yml

@@ -29,7 +29,7 @@ files:
     source_ref: "source/bsx.c:857-882"
     aliases: ["BS-X.bios"]
     validation: [size]
-    notes: |
+    note: |
       Loaded by BSX_LoadBIOS() from system_dir when core option
       chimerasnes_bsx_bios is set to 'load' (default: skip).
       Tries BS-X.bin first, then BS-X.bios as fallback.
@@ -41,7 +41,7 @@ files:
     required: true
     size: 262144
     source_ref: "source/memmap.c:275-289"
-    notes: |
+    note: |
       Loaded by LoadSFTBIOS() from system_dir when Sufami Turbo game
       detected (BANDAI SFC-ADX header at ROM offset 0, memmap.c:833).
       Reads 0x40000 bytes into Memory.ROM. No validation performed.

emulators/crocods.yml

@@ -45,20 +45,20 @@ files: []
 platform_details:
   bios_mapping:
     source_ref: "crocods-core/vga.c:185-200, crocods-core/platform.c:1009-1020"
-    notes: |
+    note: |
       All ROMs are embedded. InitMemCPC() copies cpc6128_bin and romdisc_bin
       into ROMINF and ROMEXT arrays via memcpy. No filesystem lookup occurs.
       retro_set_environment() does not request system_directory.
 
   embedded_roms:
     source_ref: "crocods-core/cpc6128.bin.c, crocods-core/romdisc.bin.c"
-    notes: |
+    note: |
       2 ROM sets embedded as C byte arrays:
       cpc6128_bin (32KB) - CPC 6128 OS (lower 16KB) + BASIC 1.1 (upper 16KB)
       romdisc_bin (16KB) - AMSDOS disk controller ROM, mapped to slot 7
 
   model_rom_map:
     source_ref: "crocods-core/vga.c:189-192"
-    notes: |
+    note: |
       CPC 6128 only: OS in ROMINF, BASIC in ROMEXT[0], AMSDOS in ROMEXT[7]
       emulator_patch_ROM() applies language patches to ROMINF after loading

emulators/desmume.yml

@@ -24,7 +24,7 @@ files:
     size: 16384
     validation: [size]
     source_ref: "desmume/src/NDSSystem.cpp:2178-2182, frontend/libretro/libretro.cpp:763"
-    notes: "Native file needed for firmware boot and SWI-from-BIOS accuracy"
+    note: "Native file needed for firmware boot and SWI-from-BIOS accuracy"
 
   - name: "bios9.bin"
     system: nintendo-ds
@@ -34,7 +34,7 @@ files:
     size: 4096
     validation: [size]
     source_ref: "desmume/src/NDSSystem.cpp:2236-2239, frontend/libretro/libretro.cpp:764"
-    notes: "Native file needed for firmware boot and logo comparison (Pal Park)"
+    note: "Native file needed for firmware boot and logo comparison (Pal Park)"
 
   - name: "firmware.bin"
     system: nintendo-ds
@@ -42,4 +42,4 @@ files:
     required: false
     hle_fallback: true
     source_ref: "desmume/src/firmware.cpp:249-280, frontend/libretro/libretro.cpp:765"
-    notes: "Loaded only if both BIOS files present; needed for boot animation, wifi config, user settings"
+    note: "Loaded only if both BIOS files present; needed for boot animation, wifi config, user settings"

emulators/dosbox_core.yml

@@ -58,7 +58,7 @@ files:
     size: 65536
     sha1: "b083518fffb7f66b03c23b7eb4f868e62dc5a987"
     source_ref: "midi_mt32.cpp:55, ROMInfo.cpp:67, dosbox_core_libretro.info:firmware0"
-    notes: "version referenced in .info file (md5: 5626206284b22c2734f3e9efefcd2675)"
+    note: "version referenced in .info file (md5: 5626206284b22c2734f3e9efefcd2675)"
 
   - name: "MT32_CONTROL.ROM"
     description: "MT-32 Control BlueRidge"
@@ -112,7 +112,7 @@ files:
     size: 65536
     sha1: "a439fbb390da38cada95a7cbb1d6ca199cd66ef8"
     source_ref: "midi_mt32.cpp:53, ROMInfo.cpp:76, dosbox_core_libretro.info:firmware2"
-    notes: "version referenced in .info file (md5: bfff32b6144c1d706109accb6e6b1113)"
+    note: "version referenced in .info file (md5: bfff32b6144c1d706109accb6e6b1113)"
 
   - name: "CM32L_CONTROL.ROM"
     description: "CM-32LN/CM-500/LAPC-N Control v1.00"
@@ -121,7 +121,7 @@ files:
     size: 65536
     sha1: "dc1c5b1b90a4646d00f7daf3679733c7badc7077"
     source_ref: "midi_mt32.cpp:53, ROMInfo.cpp:77"
-    notes: "MUNT recognizes this ROM when named CM32L_CONTROL.ROM"
+    note: "MUNT recognizes this ROM when named CM32L_CONTROL.ROM"
 
   # -- PCM ROMs --
 
@@ -132,7 +132,7 @@ files:
     size: 524288
     sha1: "f6b1eebc4b2d200ec6d3d21d51325d5b48c60252"
     source_ref: "midi_mt32.cpp:66, ROMInfo.cpp:81, dosbox_core_libretro.info:firmware1"
-    notes: "pairs with any MT-32 v1.x control ROM (md5: 89e42e386e82e0cacb4a2704a03706ca)"
+    note: "pairs with any MT-32 v1.x control ROM (md5: 89e42e386e82e0cacb4a2704a03706ca)"
 
   - name: "CM32L_PCM.ROM"
     description: "CM-32L/CM-64/LAPC-I PCM ROM"
@@ -141,7 +141,7 @@ files:
     size: 1048576
     sha1: "289cc298ad532b702461bfc738009d9ebe8025ea"
     source_ref: "midi_mt32.cpp:64, ROMInfo.cpp:85, dosbox_core_libretro.info:firmware3"
-    notes: "pairs with MT-32 v2.x or CM-32L control ROMs (md5: 08cdcfa0ed93e9cb16afa76e6ac5f0a4)"
+    note: "pairs with MT-32 v2.x or CM-32L control ROMs (md5: 08cdcfa0ed93e9cb16afa76e6ac5f0a4)"
 
   # -- BASS shared libraries (BASSMIDI driver) --
   # Downloaded from https://www.un4seen.com, placed in system directory.
@@ -152,42 +152,42 @@ files:
     required: false
     hle_fallback: true
     source_ref: "midi_bassmidi.cpp:238, dosbox_core_libretro.info:firmware4"
-    notes: "proprietary library from un4seen.com, not a ROM"
+    note: "proprietary library from un4seen.com, not a ROM"
 
   - name: "libbassmidi.so"
     description: "BASSMIDI addon library (Linux)"
     required: false
     hle_fallback: true
     source_ref: "midi_bassmidi.cpp:239, dosbox_core_libretro.info:firmware5"
-    notes: "proprietary library from un4seen.com, not a ROM"
+    note: "proprietary library from un4seen.com, not a ROM"
 
   - name: "bass.dll"
     description: "BASS audio library (Windows)"
     required: false
     hle_fallback: true
     source_ref: "midi_bassmidi.cpp:232, dosbox_core_libretro.info:firmware6"
-    notes: "proprietary library from un4seen.com, not a ROM"
+    note: "proprietary library from un4seen.com, not a ROM"
 
   - name: "bassmidi.dll"
     description: "BASSMIDI addon library (Windows)"
     required: false
     hle_fallback: true
     source_ref: "midi_bassmidi.cpp:233, dosbox_core_libretro.info:firmware7"
-    notes: "proprietary library from un4seen.com, not a ROM"
+    note: "proprietary library from un4seen.com, not a ROM"
 
   - name: "libbass.dylib"
     description: "BASS audio library (macOS)"
     required: false
     hle_fallback: true
     source_ref: "midi_bassmidi.cpp:235, dosbox_core_libretro.info:firmware8"
-    notes: "proprietary library from un4seen.com, not a ROM"
+    note: "proprietary library from un4seen.com, not a ROM"
 
   - name: "libbassmidi.dylib"
     description: "BASSMIDI addon library (macOS)"
     required: false
     hle_fallback: true
     source_ref: "midi_bassmidi.cpp:236, dosbox_core_libretro.info:firmware9"
-    notes: "proprietary library from un4seen.com, not a ROM"
+    note: "proprietary library from un4seen.com, not a ROM"
 
   # -- General MIDI SoundFont --
   # Placed in system/soundfonts/ directory. Core scans for .sf2/.sf3/.sfz/.dls/.gig.

emulators/dosbox_pure.yml

@@ -164,7 +164,7 @@ files:
     sha1: "f6b1eebc4b2d200ec6d3d21d51325d5b48c60252"
     validation: [sha1, size]
     source_ref: "mt32emu.h:5126,5143"
-    notes: "pairs with any MT-32 v1.x control ROM"
+    note: "pairs with any MT-32 v1.x control ROM"
 
   - name: "CM32L_PCM.ROM"
     description: "CM-32L/CM-64/LAPC-I PCM ROM"
@@ -174,7 +174,7 @@ files:
     sha1: "289cc298ad532b702461bfc738009d9ebe8025ea"
     validation: [sha1, size]
     source_ref: "mt32emu.h:5127,5144"
-    notes: "pairs with MT-32 v2.x or CM-32L control ROMs. Lower half aliases MT-32 PCM."
+    note: "pairs with MT-32 v2.x or CM-32L control ROMs. Lower half aliases MT-32 PCM."
 
   # -- General MIDI SoundFont --
 
@@ -183,7 +183,7 @@ files:
     required: false
     hle_fallback: true
     source_ref: "dosbox_pure_libretro.cpp:1375,2760"
-    notes: >
+    note: >
       Any .SF2 or .SF3 file in the system directory works. The core lists all
       found SoundFonts in the MIDI config dropdown. DOSBOX.SF2 is the conventional
       name and is also auto-detected when placed inside game content on C: drive.

emulators/duckstation.yml

@@ -1080,7 +1080,7 @@ files:
     fast_boot: Type2
     priority: 150
     source_ref: "src/core/bios.cpp:138"
-    notes: "Sony Bravia TV with embedded PS2"
+    note: "Sony Bravia TV with embedded PS2"
 
   # -- OpenBIOS (signature-based detection, no fixed hash) --
 
@@ -1093,4 +1093,4 @@ files:
     fast_boot: unsupported
     priority: 200
     source_ref: "src/core/bios.cpp:144-146"
-    notes: "Detected by 'OpenBIOS' signature at offset 0x78, not by MD5 hash"
+    note: "Detected by 'OpenBIOS' signature at offset 0x78, not by MD5 hash"

emulators/ecwolf.yml

@@ -38,7 +38,7 @@ files:
     required: true
     md5: "c011b428819eea4a80b455c245a5a04d"
     source_ref: "version.h:12 (MAIN_PK3), wl_iwad.cpp:642-657 (open + fatal), libretro.cpp:831-832 (sysDir)"
-    notes: >
+    note: >
       Built from wadsrc/static/ via zipdir. Contains IWADINFO (game detection rules),
       palettes (wolfpal, spearpal, blakepal, noahpal), map lump remappers (wl6map,
       sodmap, etc.), DECORATE actor definitions, MAPINFO, SNDINFO, SNDSEQ, textures,

emulators/emux_chip8.yml

@@ -43,7 +43,7 @@ platform_details:
   bios_mapping:
     target: "none"
     source_ref: "mach/chip8.c:40-57, mach/chip8.c:98-115"
-    notes: |
+    note: |
       No external BIOS. The 80-byte character font is compiled into the
       binary as char_mem[] and memcpy'd into RAM[0x000] on every reset.
       This is standard CHIP-8 behavior -- all interpreters embed the font.

emulators/fake08.yml

@@ -37,14 +37,14 @@ platform_details:
   cartridge_format:
     extensions: "p8, png"
     source_ref: "platform/libretro/libretro.cpp:258"
-    notes: |
+    note: |
       .p8 is the PICO-8 text cartridge format containing Lua code, gfx,
       gff, map, sfx, and music sections. .png is the cartridge-as-image
       format where cart data is steganographically encoded in the image.
 
   runtime:
     source_ref: "source/vm.h, source/p8GlobalLuaFunctions.h"
-    notes: |
+    note: |
       The FAKE-08 VM reimplements the PICO-8 API (128x128 screen, 16 colors,
       4-channel audio, Lua scripting) entirely in C++. The built-in BIOS
       provides a cart browser and error display. Audio runs at 22050 Hz

emulators/fceumm.yml

@@ -29,7 +29,7 @@ files:
     size: 8192
     validation: [size]
     source_ref: "src/fds.c:636-667 (FDSLoad), src/general.c:64-66 (FCEUMKF_FDSROM)"
-    notes: "Loaded at 0xE000, mapped as 8 KB PRG bank 0. Load fails if missing or short read."
+    note: "Loaded at 0xE000, mapped as 8 KB PRG bank 0. Load fails if missing or short read."
 
   # --- Game Genie ROM (optional, core option fceumm_game_genie) ---
   - name: "gamegenie.nes"
@@ -37,7 +37,7 @@ files:
     description: "Game Genie add-on cartridge ROM"
     required: false
     source_ref: "src/cart.c:344-398 (FCEU_OpenGenie), src/general.c:60-62 (FCEUMKF_GGROM)"
-    notes: "iNES format ROM (4 KB PRG + 256 bytes CHR). Core option disabled by default. Only applies to cartridge games."
+    note: "iNES format ROM (4 KB PRG + 256 bytes CHR). Core option disabled by default. Only applies to cartridge games."
 
   # --- Custom palette (optional, core option fceumm_palette) ---
   - name: "nes.pal"
@@ -45,4 +45,4 @@ files:
     description: "External NES color palette"
     required: false
     source_ref: "src/palette.c:170-200 (FCEU_LoadGamePalette), src/general.c:68-70 (FCEUMKF_PALETTE), src/drivers/libretro/libretro.c:1789-1798"
-    notes: "RGB triplets (64 standard or 512 with de-emphasis). Only loaded when palette core option is set to Custom."
+    note: "RGB triplets (64 standard or 512 with de-emphasis). Only loaded when palette core option is set to Custom."

emulators/fixgb.yml

@@ -35,4 +35,4 @@ files:
     md5: "dbfce9db9deaa2567f6a84fde55f9680"
     sha1: "1293d68bf9643bc4f36954c1e80e38f39864528d"
     source_ref: "libretro/libretro.c:246-254 (doOpenCGBBootrom), mem.c:567-586 (memInitCGBBootrom)"
-    notes: "Minimum 0x900 (2304) bytes. Only first 0x900 bytes read. Disabled via memDisableCGBBootrom() on register write."
+    note: "Minimum 0x900 (2304) bytes. Only first 0x900 bytes read. Disabled via memDisableCGBBootrom() on register write."

emulators/freechaf.yml

@@ -58,7 +58,7 @@ platform_details:
   bios_mapping:
     target: "0x000-0x7FF in 64K memory space"
     source_ref: "src/memory.h:27-29, src/memory.c:29-61"
-    notes: |
+    note: |
       MEMORY_loadSysROM_libretro() reads the file and copies it into
       Memory[] at the given address offset. PSU1 is loaded at 0x000,
       PSU2 at 0x400. The loader caps file size to (MEMORY_SIZE - address)
@@ -67,7 +67,7 @@ platform_details:
 
   hle_fallback:
     source_ref: "src/channelf_hle.c"
-    notes: |
+    note: |
       When BIOS files are missing, FreeChaF uses HLE to emulate the
       PSU routines in software. This is marked as experimental and may
       cause compatibility issues with some games. Each PSU can
@@ -75,7 +75,7 @@ platform_details:
 
   load_priority:
     source_ref: "src/libretro.c:186-198"
-    notes: |
+    note: |
       PSU1 loading order: sl90025.bin (Channel F II) first, then
       sl31253.bin (original Channel F) as fallback. If both fail,
       HLE is used. sl90025.bin is the preferred BIOS as it includes

emulators/freej2me.yml

@@ -25,4 +25,4 @@ files:
     description: "FreeJ2ME libretro Java application"
     required: true
     source_ref: "src/libretro/freej2me_libretro.c:483-486 (GET_SYSTEM_DIRECTORY + fill_pathname_join + java -jar)"
-    notes: "Not a BIOS dump. Java emulator loaded by the native core at startup via execvp('java', '-jar', path). Built from source via 'ant'. Must be in the system directory root."
+    note: "Not a BIOS dump. Java emulator loaded by the native core at startup via execvp('java', '-jar', path). Built from source via 'ant'. Must be in the system directory root."

emulators/fuse.yml

@@ -420,7 +420,7 @@ files:
 platform_details:
   bios_mapping:
     source_ref: "src/compat/file.c:55-89, 129-223"
-    notes: |
+    note: |
       ROM resolution order in compat_file_open():
       1. Check mem_entries[] (18 embedded ROMs compiled as .h arrays)
       2. If not found, try {system_dir}/fuse/{filename} on filesystem
@@ -429,7 +429,7 @@ platform_details:
 
   embedded_roms:
     source_ref: "src/compat/file.c:55-73"
-    notes: |
+    note: |
       18 ROMs embedded in the binary via .h headers generated from .rom files:
       48.rom, 128-0.rom, 128-1.rom, plus2-0.rom, plus2-1.rom,
       plus3-0/1/2/3.rom, plus3e-0/1/2/3.rom, se-0.rom, se-1.rom,
@@ -440,7 +440,7 @@ platform_details:
 
   machine_rom_map:
     source_ref: "fuse/settings.c:209-260, fuse/machines/*.c"
-    notes: |
+    note: |
       Spectrum 16K:       48.rom (1 ROM)
       Spectrum 48K:       48.rom (1 ROM)
       Spectrum 48K NTSC:  48.rom (1 ROM)
@@ -460,7 +460,7 @@ platform_details:
 
   rom_copyright:
     source_ref: "fuse/roms/README.copyright"
-    notes: |
+    note: |
       Most ROMs are copyright Amstrad. Amstrad allows free distribution but
       retains copyright. Selling ROMs standalone is not permitted. SE ROMs
       are GPLv2+. DISCiPLE/+D ROMs are copyright Datel, distribution allowed.

emulators/gam4980.yml

@@ -54,7 +54,7 @@ platform_details:
   bios_mapping:
     target: "0x800000-0x9FFFFF (font), 0xE00000-0xFFFFFF (OS) in banked address space"
     source_ref: "src/libretro.c:109-110, 300-305"
-    notes: |
+    note: |
       sys.rom_8 and sys.rom_e are flat 2 MB arrays. The CPU accesses them
       through bank-switched memory (PA() macro resolves virtual to physical
       address). rom_8_vread and rom_e_vread handle indirect reads via
@@ -62,7 +62,7 @@ platform_details:
 
   load_path:
     source_ref: "src/libretro.c:1173-1175"
-    notes: |
+    note: |
       retro_init() builds the path as {system_directory}/gam4980/ and
       passes it to sys_init(). Files must be named exactly 8.BIN and
       E.BIN (case sensitive on Linux). No .info firmware declarations

emulators/gambatte.yml

@@ -42,7 +42,7 @@ files:
     size: 256
     validation: {core: [size], upstream: [size, crc32]}
     source_ref: "libretro.cpp:1303-1363 (get_bootloader_from_file), bootloader.cpp:20-55 (load)"
-    notes: "Mapped at 0x0000-0x00FF, swapped out when register 0xFF50 is written."
+    note: "Mapped at 0x0000-0x00FF, swapped out when register 0xFF50 is written."
 
   - name: "gbc_bios.bin"
     system: nintendo-gbc
@@ -52,4 +52,4 @@ files:
     size: 2304
     validation: {core: [size], upstream: [size, crc32]}
     source_ref: "libretro.cpp:1303-1363 (get_bootloader_from_file), bootloader.cpp:20-55 (load)"
-    notes: "Mapped at 0x0000-0x08FF with cartridge data preserved at 0x0100-0x01FF. Also used for GBA mode with a patch at 0xF2. Presence required for FORCE_CGB flag when hw mode is GBC or GBA."
+    note: "Mapped at 0x0000-0x08FF with cartridge data preserved at 0x0100-0x01FF. Also used for GBA mode with a patch at 0xF2. Presence required for FORCE_CGB flag when hw mode is GBC or GBA."

emulators/geargrafx.yml

@@ -41,7 +41,7 @@ files:
     required: true
     validation: [size, crc32]
     source_ref: "libretro.cpp:453,471-473, media.cpp:241-307, defines.h:52, game_db.h:50,52"
-    notes: >
+    note: >
       Default BIOS for CD-ROM games (cdrom_bios Auto or System Card 3).
       game_db.h recognizes Japan (CRC32 6D9A73EF) and USA (CRC32 2B5B75FE)
       variants under the same filename.
@@ -52,7 +52,7 @@ files:
     required: false
     validation: [size, crc32]
     source_ref: "libretro.cpp:452,462-463, media.cpp:241-307, game_db.h:48-49,51"
-    notes: >
+    note: >
       cdrom_bios = 'System Card 2'. For older CD-ROM2 titles. game_db.h
       recognizes three variants: v2.0 Japan (CRC32 52520BC6), v2.1 Japan
       (CRC32 283B74E0), and USA (CRC32 FF2A5EC3).
@@ -63,7 +63,7 @@ files:
     required: false
     validation: [size, crc32]
     source_ref: "libretro.cpp:451,459-460, media.cpp:241-307, game_db.h:47"
-    notes: >
+    note: >
       cdrom_bios = 'System Card 1'. Very early CD-ROM2 games only.
       CRC32 3F9F95A4.
 
@@ -73,7 +73,7 @@ files:
     required: false
     validation: [size, crc32]
     source_ref: "libretro.cpp:454,468-469,481-482, media.cpp:241-307, defines.h:53, game_db.h:53-54"
-    notes: >
+    note: >
       Always loaded alongside the selected System Card BIOS (libretro.cpp:481).
       Required for Game Express CD-ROM titles. game_db.h recognizes Blue Version
       (CRC32 51A12D90) and Green Version (CRC32 16AAF05A).

emulators/gearlynx.yml

@@ -44,4 +44,4 @@ files:
     crc32: "0d973c9d"
     validation: [size, crc32]
     source_ref: "libretro.cpp:105-129 (load_bootroms), media.cpp:274-329 (LoadBios), defines.h:52 (GLYNX_BIOS_SIZE=0x200), game_db.h:38 (GLYNX_DB_BIOS_CRC=0x0D973C9D), gearlynx_core_inline.h:33-37 (no-bios guard)"
-    notes: "512-byte boot ROM validated by CRC32 after load. Invalid CRC logs a warning but still works. Missing or wrong-size file blocks emulation entirely (no HLE fallback)."
+    note: "512-byte boot ROM validated by CRC32 after load. Invalid CRC logs a warning but still works. Missing or wrong-size file blocks emulation entirely (no HLE fallback)."

emulators/gearsystem.yml

@@ -44,7 +44,7 @@ platform_details:
   mastersystem:
     bios_filename: "bios.sms"
     source_ref: "src/Memory.cpp:223-228"
-    notes: |
+    note: |
       Boot ROM loaded via LoadBootromSMS() -> LoadBootroom(path, false).
       Raw binary read, stored in m_pBootromSMS. Bank count computed as
       Pow2Ceil(size / 0x4000). Memory mapping controlled by port 3E bit 3.
@@ -52,13 +52,13 @@ platform_details:
   gamegear:
     bios_filename: "bios.gg"
     source_ref: "src/Memory.cpp:230-235"
-    notes: |
+    note: |
       Boot ROM loaded via LoadBootromGG() -> LoadBootroom(path, true).
       Raw binary read, stored in m_pBootromGG. Same bank computation.
       Supports standard GG BIOS and Majesco 1KB variant.
 
   sg1000:
     bios_filename: null
-    notes: |
+    note: |
       No BIOS support. Memory.cpp:291 returns false from IsBootromEnabled()
       when IsSG1000() or IsGameGearInSMSMode() is true.

emulators/genesis_plus_gx.yml

@@ -127,7 +127,7 @@ platform_details:
   megacd:
     bootrom_size: 131072      # 128 KB
     source_ref: "core/cd_hw/scd.h:73"
-    notes: |
+    note: |
       CD boot ROM region is auto-detected from disc image header.
       Hardware model detected from boot ROM string at offset 0x120:
         WONDER-MEGA BOOT -> Wondermega
@@ -137,14 +137,14 @@ platform_details:
   megadrive:
     tmss_rom_size: 2048       # 2 KB
     source_ref: "libretro/libretro.c:3648-3666"
-    notes: |
+    note: |
       TMSS boot ROM validated by checking "GENESIS OS" at offset 0x120.
       Only loaded when genesis_plus_gx_bios core option is enabled.
 
   mastersystem:
     bios_max_size: 4194304    # 4 MB (stored above cart ROM)
     source_ref: "core/loadrom.c:504-527"
-    notes: |
+    note: |
       BIOS ROM loaded into cart.rom + 0x400000. SEGA mapper assumed
       for ROMs larger than 48KB, otherwise no mapper.
       Region selected based on current region_code setting.
@@ -152,6 +152,6 @@ platform_details:
   gamegear:
     bios_max_size: 4194304    # 4 MB (stored above cart ROM)
     source_ref: "core/loadrom.c:467-489"
-    notes: |
+    note: |
       Handles 1KB Majesco GG BIOS (mapped to $0000-$03FF) and
       standard larger BIOS ROMs.

emulators/gpsp.yml

@@ -50,7 +50,7 @@ platform_details:
     bios_size: 16384
     hle_bios: true
     source_ref: "libretro/libretro.c:1100-1131, bios/source/"
-    notes: |
+    note: |
       The built-in BIOS (open_gba_bios_rom, 16 KB) is an open-source
       reimplementation compiled from bios/source/. It implements most
       SWI calls (SoftReset, RegisterRamReset, Halt, VBlankIntrWait,

emulators/handy.yml

@@ -45,11 +45,11 @@ files:
     crc32: "0d973c9d"
     validation: [size, crc32]
     source_ref: "rom.h:48-49 (ROM_SIZE=0x200, ROM_CRC32=0x0D973C9D), rom.cpp:76-129 (CRom constructor), libretro.cpp:1231-1258 (bios path + CSystem init)"
-    notes: "Validated by CRC32 at load time. If invalid or missing, core uses HLE fallback (system.cpp:303-361 HLE_BIOS_* functions, system.cpp:406-428 trap writes)."
+    note: "Validated by CRC32 at load time. If invalid or missing, core uses HLE fallback (system.cpp:303-361 HLE_BIOS_* functions, system.cpp:406-428 trap writes)."
 
   - name: "howard.o"
     system: atari-lynx
     description: "Epyx Howard bootloader for headerless cartridges"
     required: false
     source_ref: "system.cpp:197-238 (CartHeaderLess check, howard.o load via fill_pathname_resolve_relative)"
-    notes: "Loaded only for headerless carts (no LNX/BS93 header). Resolved relative to the BIOS file path (system directory). Passed to CRam for execution. Most commercial games have headers and skip this entirely."
+    note: "Loaded only for headerless carts (no LNX/BS93 header). Resolved relative to the BIOS file path (system directory). Passed to CRam for execution. Most commercial games have headers and skip this entirely."

emulators/jaxe.yml

@@ -41,7 +41,7 @@ platform_details:
   bios_mapping:
     target: "none"
     source_ref: "jaxe_libretro.info:17, src/chip8.c:118-168"
-    notes: |
+    note: |
       All font/sprite data is compiled into the binary. The standard
       CHIP-8 hex font (5 bytes per character, 16 characters) and the
       SCHIP big hex font (10 bytes per character, 16 characters) are

emulators/jollycv.yml

@@ -53,7 +53,7 @@ files:
     size: 8192
     validation: [size]
     source_ref: "libretro/libretro.c:701, src/jcv_coleco.c:402-406"
-    notes: "Mapped at 0x0000-0x1FFF. Replaced by SGM lower RAM when Super Game Module is active. Must be exactly 8192 bytes."
+    note: "Mapped at 0x0000-0x1FFF. Replaced by SGM lower RAM when Super Game Module is active. Must be exactly 8192 bytes."
 
   # --- CreatiVision BIOS (required for CreatiVision games) ---
   - name: "bioscv.rom"
@@ -63,7 +63,7 @@ files:
     size: 2048
     validation: [size]
     source_ref: "libretro/libretro.c:711, src/jcv_crvision.c:315-318"
-    notes: "Mapped at 0xF800-0xFFFF. Must be exactly 2048 bytes."
+    note: "Mapped at 0xF800-0xFFFF. Must be exactly 2048 bytes."
 
 platform_details:
   colecovision:
@@ -80,4 +80,4 @@ platform_details:
 
   myvision:
     bios_required: false
-    notes: "No BIOS needed. My Vision games run without any system ROM."
+    note: "No BIOS needed. My Vision games run without any system ROM."

emulators/mednafen_pce.yml

@@ -27,21 +27,21 @@ files:
     region: "NTSC-J"
     required: true
     source_ref: "libretro.cpp:1051-1052, settings.cpp:40"
-    notes: "Default value for pce_cdbios option."
+    note: "Default value for pce_cdbios option."
 
   - name: "syscard2.pce"
     description: "CD-ROM System Card 2.0 (Japan)"
     region: "NTSC-J"
     required: false
     source_ref: "libretro.cpp:1053-1054"
-    notes: "pce_cdbios = 'System Card 2'."
+    note: "pce_cdbios = 'System Card 2'."
 
   - name: "syscard1.pce"
     description: "CD-ROM System Card 1.0 (Japan)"
     region: "NTSC-J"
     required: false
     source_ref: "libretro.cpp:1055-1056"
-    notes: "pce_cdbios = 'System Card 1'."
+    note: "pce_cdbios = 'System Card 1'."
 
   - name: "gexpress.pce"
     description: "Games Express CD Card"
@@ -49,18 +49,18 @@ files:
     required: false
     aliases: ["gecard.pce"]
     source_ref: "libretro.cpp:1057-1058, settings.cpp:41, pce.cpp:373-411"
-    notes: "pce_cdbios = 'Games Express' or auto-detected via DetectGECD()."
+    note: "pce_cdbios = 'Games Express' or auto-detected via DetectGECD()."
 
   - name: "syscard3u.pce"
     description: "CD-ROM System Card 3.0 (US / TurboGrafx-CD)"
     region: "NTSC-U"
     required: false
     source_ref: "libretro.cpp:1059-1060"
-    notes: "pce_cdbios = 'System Card 3 US'. Not in .info."
+    note: "pce_cdbios = 'System Card 3 US'. Not in .info."
 
   - name: "syscard2u.pce"
     description: "CD-ROM System Card 2.0 (US / TurboGrafx-CD)"
     region: "NTSC-U"
     required: false
     source_ref: "libretro.cpp:1061-1062"
-    notes: "pce_cdbios = 'System Card 2 US'. Not in .info."
+    note: "pce_cdbios = 'System Card 2 US'. Not in .info."

emulators/mednafen_pce_fast.yml

@@ -25,21 +25,21 @@ files:
     region: "NTSC-J"
     required: true
     source_ref: "libretro.cpp:67, libretro.cpp:1755-1760"
-    notes: "Default value for pce_fast_cdbios option."
+    note: "Default value for pce_fast_cdbios option."
 
   - name: "syscard2.pce"
     description: "CD-ROM System Card 2.0 (Japan)"
     region: "NTSC-J"
     required: false
     source_ref: "libretro.cpp:1762"
-    notes: "pce_fast_cdbios = 'System Card 2'."
+    note: "pce_fast_cdbios = 'System Card 2'."
 
   - name: "syscard1.pce"
     description: "CD-ROM System Card 1.0 (Japan)"
     region: "NTSC-J"
     required: false
     source_ref: "libretro.cpp:1764"
-    notes: "pce_fast_cdbios = 'System Card 1'."
+    note: "pce_fast_cdbios = 'System Card 1'."
 
   - name: "gexpress.pce"
     description: "Games Express CD Card"
@@ -47,18 +47,18 @@ files:
     required: false
     aliases: ["gecard.pce"]
     source_ref: "libretro.cpp:1765-1766"
-    notes: "pce_fast_cdbios = 'Games Express'. For unlicensed Games Express titles."
+    note: "pce_fast_cdbios = 'Games Express'. For unlicensed Games Express titles."
 
   - name: "syscard3u.pce"
     description: "CD-ROM System Card 3.0 (US / TurboGrafx-CD)"
     region: "NTSC-U"
     required: false
     source_ref: "libretro.cpp:1767-1768"
-    notes: "pce_fast_cdbios = 'System Card 3 US'. Not in .info."
+    note: "pce_fast_cdbios = 'System Card 3 US'. Not in .info."
 
   - name: "syscard2u.pce"
     description: "CD-ROM System Card 2.0 (US / TurboGrafx-CD)"
     region: "NTSC-U"
     required: false
     source_ref: "libretro.cpp:1769-1770"
-    notes: "pce_fast_cdbios = 'System Card 2 US'. Not in .info."
+    note: "pce_fast_cdbios = 'System Card 2 US'. Not in .info."

emulators/mednafen_supergrafx.yml

@@ -29,25 +29,25 @@ files:
     region: "NTSC-J"
     required: true
     source_ref: "libretro.cpp:972-973, mednafen/settings.cpp:37"
-    notes: "Default value for sgx_cdbios option."
+    note: "Default value for sgx_cdbios option."
 
   - name: "syscard2.pce"
     description: "CD-ROM System Card 2.0 (Japan)"
     region: "NTSC-J"
     required: false
     source_ref: "libretro.cpp:974-975"
-    notes: "sgx_cdbios = 'System Card 2'."
+    note: "sgx_cdbios = 'System Card 2'."
 
   - name: "syscard1.pce"
     description: "CD-ROM System Card 1.0 (Japan)"
     region: "NTSC-J"
     required: false
     source_ref: "libretro.cpp:976-977"
-    notes: "sgx_cdbios = 'System Card 1'."
+    note: "sgx_cdbios = 'System Card 1'."
 
   - name: "gexpress.pce"
     description: "Games Express CD Card"
     region: "NTSC-J"
     required: false
     source_ref: "libretro.cpp:978-979, mednafen/pce_fast/pce.cpp:330-367,453-454"
-    notes: "sgx_cdbios = 'Games Express' or auto-detected via DetectGECD()."
+    note: "sgx_cdbios = 'Games Express' or auto-detected via DetectGECD()."

emulators/melonds.yml

@@ -26,7 +26,7 @@ files:
     validation: {core: [size], upstream: [size, crc32]}
     crc32: "0x2ab23573"
     source_ref: "src/NDS.h:196, src/NDS.cpp:467-477, src/frontend/Util_ROM.cpp:99-111"
-    notes: "FreeBIOS fallback (src/FreeBIOS.h); native needed for Key1 cartridge crypto"
+    note: "FreeBIOS fallback (src/FreeBIOS.h); native needed for Key1 cartridge crypto"
 
   - name: bios7.bin
     system: nintendo-ds
@@ -37,7 +37,7 @@ files:
     validation: {core: [size], upstream: [size, crc32]}
     crc32: "0x1280f0d5"
     source_ref: "src/NDS.h:197, src/NDS.cpp:482-492, src/frontend/Util_ROM.cpp:117-131"
-    notes: "FreeBIOS fallback (src/FreeBIOS.h); native needed for Key1 init at offset 0x0030"
+    note: "FreeBIOS fallback (src/FreeBIOS.h); native needed for Key1 init at offset 0x0030"
 
   - name: firmware.bin
     system: nintendo-ds
@@ -46,7 +46,7 @@ files:
     hle_fallback: true
     validation: [size]
     source_ref: "src/SPI.cpp:192-211, src/frontend/Util_ROM.cpp:174-195"
-    notes: "Generated 128KB firmware as fallback; native must be 256KB or 512KB for boot"
+    note: "Generated 128KB firmware as fallback; native must be 256KB or 512KB for boot"
 
   # --- Nintendo DSi (TWL) ---
   - name: dsi_bios9.bin
@@ -66,7 +66,7 @@ files:
     validation: {core: [size], upstream: [size, crc32]}
     crc32: "0x4316CC42"
     source_ref: "src/DSi.h:34, src/DSi.cpp:604-620, src/frontend/Util_ROM.cpp:158-170"
-    notes: "Contains eMMC key-Y at offset 0x8308 for NAND init"
+    note: "Contains eMMC key-Y at offset 0x8308 for NAND init"
 
   - name: dsi_firmware.bin
     system: nintendo-dsi
@@ -81,11 +81,11 @@ files:
     description: "DSi NAND dump"
     required: true
     source_ref: "src/frontend/Util_ROM.cpp:224-235, src/DSi_NAND.cpp"
-    notes: "Uses AES keys from ARM7i BIOS offset 0x8308"
+    note: "Uses AES keys from ARM7i BIOS offset 0x8308"
 
   - name: dsi_sd_card.bin
     system: nintendo-dsi
     description: "DSi SD card image"
     required: false
     source_ref: "src/frontend/Util_ROM.cpp:237-243, src/libretro/libretro.cpp:837,553"
-    notes: "Created if missing; requires melonds_dsi_sdcard core option enabled"
+    note: "Created if missing; requires melonds_dsi_sdcard core option enabled"

emulators/melonds_ds.yml

@@ -46,7 +46,7 @@ files:
     required: false
     hle_fallback: true
     source_ref: "src/libretro/config/console.cpp:184"
-    notes: "Filename configurable via core options; generated firmware used as fallback"
+    note: "Filename configurable via core options; generated firmware used as fallback"
 
   # --- Nintendo DSi (TWL) ---
   - name: dsi_bios7.bin
@@ -57,7 +57,7 @@ files:
     validation: [size]
     crc32: "0x4316CC42"
     source_ref: "src/libretro/config/console.cpp:333, melonDS:src/MemConstants.h:32,44"
-    notes: "Contains eMMC key-Y at offset 0x8308 for NAND init"
+    note: "Contains eMMC key-Y at offset 0x8308 for NAND init"
 
   - name: dsi_bios9.bin
     system: nintendo-dsi
@@ -73,11 +73,11 @@ files:
     description: "DSi firmware image"
     required: true
     source_ref: "src/libretro/config/console.cpp:352-358"
-    notes: "Filename configurable via core options; must have DSi firmware header"
+    note: "Filename configurable via core options; must have DSi firmware header"
 
   - name: dsi_nand.bin
     system: nintendo-dsi
     description: "DSi NAND dump"
     required: true
     source_ref: "src/libretro/config/console.cpp:378"
-    notes: "Filename configurable via core options; 240MB or 245.5MB with optional no$cash footer"
+    note: "Filename configurable via core options; 240MB or 245.5MB with optional no$cash footer"

emulators/mesen.yml

@@ -49,7 +49,7 @@ files:
     size: 8192
     validation: [size]
     source_ref: "Core/FdsLoader.cpp:45-59 (LoadBios tries FdsBios.bin then disksys.rom), Core/FdsLoader.cpp:143-146 (LoadRom validates size == 0x2000)"
-    notes: "Mapped at 0xE000-0xFFFF as PRG ROM bank 0. Core checks FdsBios.bin first, falls back to disksys.rom. Size must be exactly 8192 bytes or BiosMissing is set."
+    note: "Mapped at 0xE000-0xFFFF as PRG ROM bank 0. Core checks FdsBios.bin first, falls back to disksys.rom. Size must be exactly 8192 bytes or BiosMissing is set."
 
   - name: "StudyBox.bin"
     system: nintendo-nes
@@ -58,7 +58,7 @@ files:
     size: 262144
     validation: [size]
     source_ref: "Core/StudyBoxLoader.cpp:125-133 (LoadBios), Core/StudyBoxLoader.cpp:149-152 (LoadRom validates size == 0x40000)"
-    notes: "256 KB BIOS for the Study Box tape peripheral (mapper 186). Only needed for .stbx tape dumps. Size must be exactly 262144 bytes."
+    note: "256 KB BIOS for the Study Box tape peripheral (mapper 186). Only needed for .stbx tape dumps. Size must be exactly 262144 bytes."
 
   - name: "MesenPalette.pal"
     system: nintendo-nes
@@ -66,4 +66,4 @@ files:
     required: false
     source_ref: "Libretro/libretro.cpp:301-323 (load_custom_palette), Libretro/libretro.cpp:405-406 (called when mesen_palette == Custom)"
     validation: [size]
-    notes: "Loaded when mesen_palette core option is Custom. Accepts exactly 192 bytes (64 RGB triplets) or 1536 bytes (512 entries for emphasis combos). Falls back to built-in default palette if size doesn't match."
+    note: "Loaded when mesen_palette core option is Custom. Accepts exactly 192 bytes (64 RGB triplets) or 1536 bytes (512 entries for emphasis combos). Falls back to built-in default palette if size doesn't match."

emulators/meteor.yml

@@ -26,7 +26,7 @@ platform_details:
     bios_size: 16384
     hle_bios: true
     source_ref: "ameteor/source/bios.cpp, ameteor/source/cpu.cpp:245-311"
-    notes: |
+    note: |
       Full HLE BIOS. The libretro port never loads an external BIOS file.
       Cpu::SoftwareInterrupt() checks HasBios() — if false (always in
       libretro), SWI calls are routed to C++ reimplementations.

emulators/mgba.yml

@@ -96,7 +96,7 @@ platform_details:
     bios_size: 16384  # 16 KB
     hle_bios: true
     source_ref: "src/gba/hle-bios.c, src/gba/gba.c:520-551"
-    notes: |
+    note: |
       GBALoadBIOS() validates size (must be exactly 0x4000) then computes
       an internal checksum. Two official checksums are recognized:
         GBA_BIOS_CHECKSUM    = 0xBAAE187F (standard GBA)
@@ -107,7 +107,7 @@ platform_details:
     bios_size: 256  # 256 B
     hle_bios: false
     source_ref: "src/gb/gb.c:570-605"
-    notes: |
+    note: |
       GBIsBIOS() validates by CRC32. Accepted DMG-family checksums:
         DMG0 = 0xC2F5CC97, DMG = 0x59C8598E, MGB = 0xE6920754
       Files not matching any known checksum are rejected.
@@ -116,7 +116,7 @@ platform_details:
     bios_size: 2304  # 2304 B (0x900)
     hle_bios: false
     source_ref: "src/gb/gb.c:570-605"
-    notes: |
+    note: |
       Accepted CGB-family CRC32 checksums:
         CGB = 0x41884E46, CGB0 = 0xE8EF5318, CGBE = 0xE95DC95D
         AGB = 0xFFD6B0F1, AGB0 = 0x570337EA
@@ -125,7 +125,7 @@ platform_details:
     bios_size: 256  # 256 B
     hle_bios: false
     source_ref: "src/gb/gb.c:570-605, src/gb/core.c:642-644"
-    notes: |
+    note: |
       Accepted SGB CRC32 checksums:
         SGB = 0xEC8A83B9, SGB2 = 0x53D0DD63
       SGB2 maps here in standalone (marked TODO upstream). Libretro port

emulators/nestopia.yml

@@ -43,7 +43,7 @@ files:
     md5: "ca30b50f880eb660a320674ed365ef7a"
     sha1: "57fe1bdee955bb48d357e463ccbf129496930b62"
     source_ref: "libretro/libretro.cpp:1608-1634 (FDS load), source/core/NstFds.cpp:61-131 (Bios class, CRC32 validation)"
-    notes: "Mapped at 0xE000-0xFFFF (8 KB). retro_load_game returns false if missing when loading .fds files. CRC32 checked: Famicom 0x5E607DCF, Twin Famicom 0x4DF24A6C."
+    note: "Mapped at 0xE000-0xFFFF (8 KB). retro_load_game returns false if missing when loading .fds files. CRC32 checked: Famicom 0x5E607DCF, Twin Famicom 0x4DF24A6C."
 
   # --- NES game database (optional, overrides baked-in copy) ---
   - name: "NstDatabase.xml"
@@ -52,7 +52,7 @@ files:
     required: false
     hle_fallback: true
     source_ref: "libretro/libretro.cpp:1561-1586 (database load), libretro/nstdatabase.hpp (baked-in fallback)"
-    notes: "XML database matching games by SHA1+CRC32. Used for region, mapper, mirroring, and 4-player adapter detection. Built-in fallback exists so this file is optional."
+    note: "XML database matching games by SHA1+CRC32. Used for region, mapper, mirroring, and 4-player adapter detection. Built-in fallback exists so this file is optional."
 
   # --- Custom palette (optional, core option nestopia_palette = Custom) ---
   - name: "custom.pal"
@@ -62,7 +62,7 @@ files:
     hle_fallback: true
     size: 192
     source_ref: "libretro/libretro.cpp:1540-1559 (palette load)"
-    notes: "64 RGB triplets (64 x 3 bytes = 192 bytes). Loaded unconditionally at startup; applied only when nestopia_palette core option is set to Custom. Falls back to built-in Royaltea palette. Multiple valid palettes exist so no canonical hash."
+    note: "64 RGB triplets (64 x 3 bytes = 192 bytes). Loaded unconditionally at startup; applied only when nestopia_palette core option is set to Custom. Falls back to built-in Royaltea palette. Multiple valid palettes exist so no canonical hash."
 
   # --- ADPCM audio samples (optional, game-specific) ---
   - name: "nestopia/samples/moepro/"

emulators/noods.yml

@@ -28,7 +28,7 @@ files:
     hle_fallback: true
     size: 4096
     source_ref: "src/memory.cpp:130-141"
-    notes: "HLE fallback for all SWI calls; native needed for firmware boot and logo verification (copyBiosLogo)"
+    note: "HLE fallback for all SWI calls; native needed for firmware boot and logo verification (copyBiosLogo)"
 
   - name: "bios7.bin"
     system: nintendo-ds
@@ -37,7 +37,7 @@ files:
     hle_fallback: true
     size: 16384
     source_ref: "src/memory.cpp:144-155"
-    notes: "HLE fallback for all SWI calls; native needed for firmware boot"
+    note: "HLE fallback for all SWI calls; native needed for firmware boot"
 
   - name: "firmware.bin"
     system: nintendo-ds
@@ -45,7 +45,7 @@ files:
     required: false
     hle_fallback: true
     source_ref: "src/spi.cpp:62-160"
-    notes: "Auto-generated 128KB non-bootable firmware as fallback; native dump (>128KB) needed for firmware boot"
+    note: "Auto-generated 128KB non-bootable firmware as fallback; native dump (>128KB) needed for firmware boot"
 
   - name: "gba_bios.bin"
     system: nintendo-gba
@@ -54,11 +54,11 @@ files:
     hle_fallback: true
     size: 16384
     source_ref: "src/memory.cpp:158-168, src/core.cpp:252-256"
-    notes: "HLE fallback via swiTableGba; native BIOS disables HLE and enables real GBA boot"
+    note: "HLE fallback via swiTableGba; native BIOS disables HLE and enables real GBA boot"
 
   - name: "nds_sd_card.bin"
     system: nintendo-ds
     description: "DLDI SD card image for homebrew"
     required: false
     source_ref: "src/dldi.cpp:80-83, src/libretro/libretro.cpp:331"
-    notes: "Opened on DLDI startup() call from homebrew ROMs; user-created FAT image"
+    note: "Opened on DLDI startup() call from homebrew ROMs; user-created FAT image"

emulators/numero.yml

@@ -40,18 +40,18 @@ files:
     description: "TI-83 Plus Silver Edition ROM dump"
     required: false
     source_ref: "libretronew.cpp:576-578"
-    notes: "Checked first. Recommended for largest storage capacity."
+    note: "Checked first. Recommended for largest storage capacity."
 
   - name: "ti83plus.rom"
     system: ti-83
     description: "TI-83 Plus ROM dump"
     required: false
     source_ref: "libretronew.cpp:583-585"
-    notes: "Checked second, used if ti83se.rom is missing."
+    note: "Checked second, used if ti83se.rom is missing."
 
   - name: "ti83.rom"
     system: ti-83
     description: "TI-83 ROM dump"
     required: false
     source_ref: "libretronew.cpp:591-593"
-    notes: "Checked last. Original TI-83 (non-Plus)."
+    note: "Checked last. Original TI-83 (non-Plus)."

emulators/nxengine.yml

@@ -45,7 +45,7 @@ files:
     md5: "38695d3d69d7a0ada8178072dad4c58b"
     sha1: "bb2d0441e073da9c584f23c2ad8c7ab8aac293bf"
     source_ref: "main.cpp:77-78 (opened for extraction), libretro.cpp:258 (existence check)"
-    notes: "Placed in system/nxengine/. The core extracts ORG music, PXT sounds, stage tile attributes, BMP graphics, and wavetable from this binary at each launch."
+    note: "Placed in system/nxengine/. The core extracts ORG music, PXT sounds, stage tile attributes, BMP graphics, and wavetable from this binary at each launch."
 
   - name: "data/"
     path: "nxengine/data/"
@@ -54,7 +54,7 @@ files:
     description: "Full game asset directory tree (399 files: sprites, NPC sheets, stage maps, scripts, backgrounds)"
     required: true
     source_ref: "cachefiles.c:38-439 (filenames[] array loaded at init)"
-    notes: "Must contain root assets (Arms.pbm, MyChar.pbm, etc.), Npc/ (36 sprite sheets), and Stage/ (333 map/script/tileset files). All files from the original freeware release."
+    note: "Must contain root assets (Arms.pbm, MyChar.pbm, etc.), Npc/ (36 sprite sheets), and Stage/ (333 map/script/tileset files). All files from the original freeware release."
 
   - name: "data/npc.tbl"
     path: "nxengine/data/npc.tbl"
@@ -63,7 +63,7 @@ files:
     description: "NPC attribute table (entity behavior flags, HP, damage, display rect offsets)"
     required: true
     source_ref: "main.cpp:50 (existence check for data/ directory), ai/ai.cpp:56-59 (loaded for NPC properties)"
-    notes: "Located in system/nxengine/data/. Used to validate data directory presence and to load NPC behavior attributes."
+    note: "Located in system/nxengine/data/. Used to validate data directory presence and to load NPC behavior attributes."
 
   - name: "data/sprites.sif"
     path: "nxengine/data/sprites.sif"
@@ -73,7 +73,7 @@ files:
     required: false
     hle_fallback: true
     source_ref: "cachefiles.c:101 (in filenames[]), cachefiles.c:515-521 (compiled-in fallback from sprites_sif.h)"
-    notes: "Not shipped in the freeware distribution. If missing, the core uses a compiled-in copy (sprites_sif.h)."
+    note: "Not shipped in the freeware distribution. If missing, the core uses a compiled-in copy (sprites_sif.h)."
 
   - name: "tilekey.dat"
     path: "nxengine/tilekey.dat"
@@ -82,4 +82,4 @@ files:
     description: "Tile attribute lookup table (maps tile codes to collision/behavior attributes)"
     required: false
     source_ref: "map.cpp:290-303 (loaded at init, hardcoded default if missing)"
-    notes: "Not part of the freeware distribution. Generated by the standalone NXEngine extraction tool. The libretro core has hardcoded defaults in map.cpp:30."
+    note: "Not part of the freeware distribution. Generated by the standalone NXEngine extraction tool. The libretro core has hardcoded defaults in map.cpp:30."

emulators/panda3ds.yml

@@ -27,7 +27,7 @@ files:
     description: "AES encryption keys for decrypting encrypted ROMs"
     required: false
     source_ref: "src/emulator.cpp:229,237-238, src/core/crypto/aes_engine.cpp:13-92"
-    notes: |
+    note: |
       Loaded at ROM load time from appDataRoot/sysdata/aes_keys.txt.
       In libretro mode, appDataRoot = <save_dir>/Emulator Files/.
       Contains key slot entries (generator, keyX, keyY, normalKey).
@@ -39,7 +39,7 @@ files:
     description: "Seed database for seed-encrypted games"
     required: false
     source_ref: "src/emulator.cpp:230,241-242, src/core/loader/ncch.cpp:78-93"
-    notes: |
+    note: |
       Used for titles with seed encryption (firmware 9.6+).
       Placed alongside aes_keys.txt in the sysdata directory.
       Without it, seed-encrypted titles fail to load with a warning.

emulators/pcsx_rearmed.yml

@@ -29,7 +29,7 @@ files:
     hle_fallback: true
     validation: [size]
     source_ref: "frontend/libretro.c:3721-3724 (listed_bios[0])"
-    notes: "Preferred JP BIOS, searched first by exact filename."
+    note: "Preferred JP BIOS, searched first by exact filename."
 
   # -- Region: North America (PSX_REGION_US = 0) --
 
@@ -41,7 +41,7 @@ files:
     hle_fallback: true
     validation: [size]
     source_ref: "frontend/libretro.c:3721-3724 (listed_bios[1])"
-    notes: "Preferred US BIOS, searched first by exact filename."
+    note: "Preferred US BIOS, searched first by exact filename."
 
   # -- Region: Europe (PSX_REGION_EU = 2) --
 
@@ -53,7 +53,7 @@ files:
     hle_fallback: true
     validation: [size]
     source_ref: "frontend/libretro.c:3721-3724 (listed_bios[2])"
-    notes: "Preferred EU BIOS, searched first by exact filename."
+    note: "Preferred EU BIOS, searched first by exact filename."
 
   # -- Fallback BIOS filenames (searched in order after scph550x) --
 
@@ -65,7 +65,7 @@ files:
     hle_fallback: true
     validation: [size]
     source_ref: "frontend/libretro.c:3721-3724 (listed_bios[3])"
-    notes: "Region detected from content at runtime. Must be 512 KB in libretro context."
+    note: "Region detected from content at runtime. Must be 512 KB in libretro context."
 
   - name: "scph101.bin"
     description: "SCPH-101 (v4.4 03-24-00 A) - PSone US"
@@ -75,7 +75,7 @@ files:
     hle_fallback: true
     validation: [size]
     source_ref: "frontend/libretro.c:3721-3724 (listed_bios[4])"
-    notes: "PSone slim model."
+    note: "PSone slim model."
 
   - name: "scph7001.bin"
     description: "SCPH-7001 (v4.1 12-16-97 A)"
@@ -94,7 +94,7 @@ files:
     hle_fallback: true
     validation: [size]
     source_ref: "frontend/libretro.c:3721-3724 (listed_bios[6])"
-    notes: "Original US model. Last in the explicit filename search list."
+    note: "Original US model. Last in the explicit filename search list."
 
   # -- Dynamic scan fallback --
   # After exhausting listed_bios[], the core calls find_any_bios() which scans

emulators/pokemini.yml

@@ -59,20 +59,20 @@ files:
     hle_fallback: true
     size: 4096
     source_ref: "source/PokeMini.c:189-206 (PokeMini_LoadBIOSFile), libretro/libretro.c:565 (path)"
-    notes: "Mapped at $000000-$000FFF (4 KB). Read via Hardware.c:144-145. Falls back to embedded FreeBIOS if missing."
+    note: "Mapped at $000000-$000FFF (4 KB). Read via Hardware.c:144-145. Falls back to embedded FreeBIOS if missing."
 
 platform_details:
   bios_mapping:
     target: "$000000-$000FFF in Pokemon Mini address space (4 KB)"
     source_ref: "source/PokeMini.h:38, source/Hardware.c:144-145"
-    notes: |
+    note: |
       PM_BIOS is a 4096-byte array. CPU reads from address range
       $000000-$000FFF are served directly from this buffer. The BIOS
       handles interrupt vectors, hardware init, and the startup logo.
 
   freebios_fallback:
     source_ref: "freebios/freebios.c, source/PokeMini.c:209-214"
-    notes: |
+    note: |
       FreeBIOS is a 4096-byte open-source replacement embedded in the
       binary as a C array. It provides basic interrupt vectors and
       startup code. Loaded by default at PokeMini_Create() and used
@@ -84,7 +84,7 @@ platform_details:
 
   load_priority:
     source_ref: "source/PokeMini.c:515-523"
-    notes: |
+    note: |
       During PokeMini_Reset(), the core first reloads FreeBIOS as a
       safe baseline, then attempts to load bios.min from disk. If
       the file exists and is exactly 4096 bytes, it replaces FreeBIOS.

emulators/prboom.yml

@@ -51,4 +51,4 @@ files:
     sha1: "5f4aed208301449c2e9514edfd325fe9dead76fa"
     crc32: "a5751b99"
     source_ref: "d_main.c:1069-1078 (PACKAGE .wad load), libretro.c:1742-1784 (I_FindFile search), config.h:46 (PACKAGE=prboom)"
-    notes: "Searched in system/prboom/ then system/. Falls back to internal defaults if missing, but menus and HUD may render incorrectly without it."
+    note: "Searched in system/prboom/ then system/. Falls back to internal defaults if missing, but menus and HUD may render incorrectly without it."

emulators/race.yml

@@ -35,7 +35,7 @@ analysis:
     source_ref: "race-memory.c:337-361"
     upstream_status: optional
     upstream_ref: "memory.cpp:346-365 (8bitpsp/race)"
-    notes: |
+    note: |
       loadBIOS() is wrapped in #if 0 and always returns 0 in the libretro port.
       In upstream (8bitpsp/race, alekmaul/race), the function is live and loads
       NPBIOS.BIN optionally, falling back to HLE if not found.

emulators/rustation.yml

@@ -95,7 +95,7 @@ files:
     validation: [size, sha256]
     sha256: "0c8359870cbac0ea091f1c87f188cd332dcc709753b91cafd9fd44a4a6188197"
     source_ref: "rustation/src/bios/db.rs:108-117 (v2.2 Japan)"
-    notes: "A known-bad v2.2 J dump also exists in the DB but is rejected."
+    note: "A known-bad v2.2 J dump also exists in the DB but is rejected."
 
   - name: "scph5000.bin"
     description: "v2.2 J (alt)"

emulators/sameboy.yml

@@ -67,7 +67,7 @@ files:
     hle_fallback: true
     size: 256
     source_ref: "libretro.c:521,532,556; Core/gb.c:1600-1604"
-    notes: "Used for SGB_NTSC, SGB_PAL models. Also loaded when borrowing SGB border (Core/gb.c:264)."
+    note: "Used for SGB_NTSC, SGB_PAL models. Also loaded when borrowing SGB border (Core/gb.c:264)."
 
   - name: "sgb2_boot.bin"
     system: nintendo-sgb
@@ -84,7 +84,7 @@ files:
     hle_fallback: true
     size: 2304
     source_ref: "libretro.c:524,535,556; Core/gb.c:1613-1618"
-    notes: "Used for CGB revisions A through E in the libretro port."
+    note: "Used for CGB revisions A through E in the libretro port."
 
   - name: "agb_boot.bin"
     system: nintendo-gbc
@@ -93,7 +93,7 @@ files:
     hle_fallback: true
     size: 2304
     source_ref: "libretro.c:525,536,556; Core/gb.c:1621"
-    notes: "Enables GBA-enhanced palettes in compatible GBC games."
+    note: "Enables GBA-enhanced palettes in compatible GBC games."
 
 builtin_boot_roms:
   description: |

emulators/smsplus.yml

@@ -39,7 +39,7 @@ files:
     required: false
     aliases: ["BIOS.sms"]
     source_ref: "smsplus_libretro.c:211-229"
-    notes: |
+    note: |
       Loaded into bios.rom (up to 1 MB allocated). Only active when core
       option smsplus_sms_bios is "auto". Displays SMS startup screen
       before game execution. Standalone ports use BIOS.sms (uppercase).
@@ -50,7 +50,7 @@ files:
     required: true
     size: 8192
     source_ref: "smsplus_libretro.c:232-248"
-    notes: |
+    note: |
       Required for ColecoVision games. Read as 0x2000 (8192) bytes into
       coleco.rom. Without this file, retro_load_game() returns false for
       .col files.
@@ -62,7 +62,7 @@ files:
     size: 8192
     mode: standalone
     source_ref: "ports/sdl/smsplus.c:321-329"
-    notes: |
+    note: |
       Read as 0x2000 (8192) bytes into coleco.rom (shared buffer). Only
       in standalone builds (SORDM5_EMU define). Not compiled in libretro.
       Code does not enforce presence but system needs BIOS to function.

emulators/snes9x.yml

@@ -16,7 +16,7 @@ cores:
     source: "https://github.com/libretro/snes9x"
     firmware_loading: true
     hle_only: true
-    notes: |
+    note: |
       Loads BS-X.bin and STBIOS.bin via LoadBIOS() in libretro.cpp.
       BSX_LoadBIOS() in bsx.cpp tries BS-X.bios as fallback.
       Auto-detects Satellaview and Sufami Turbo carts on load.
@@ -33,7 +33,7 @@ files:
     validation: [size]
     source_ref: "libretro.cpp:1209, bsx.cpp:1209,1214"
     aliases: ["BS-X.bios"]
-    notes: "Needed for Satellaview (.bs) games."
+    note: "Needed for Satellaview (.bs) games."
 
   - name: "STBIOS.bin"
     system: nintendo-sufami-turbo
@@ -42,7 +42,7 @@ files:
     size: 262144
     validation: [size]
     source_ref: "libretro.cpp:1203,1317, memmap.cpp:1672"
-    notes: "Needed for Sufami Turbo multi-cart games."
+    note: "Needed for Sufami Turbo multi-cart games."
 
 notes:
   coprocessor_hle: |

emulators/snes9x2010.yml

@@ -34,7 +34,7 @@ files:
     validation: [size]
     aliases: ["BS-X.bios"]
     source_ref: "src/bsx.c:959-993 (BSX_LoadBIOS), src/bsx.c:1068 (caller in S9xInitBSX)"
-    notes: |
+    note: |
       Loaded when a BS game is auto-detected (is_bsx checks ROM header at
       0x7FC0/0xFFC0). Without this file, BSX.bootup is set to FALSE and
       BIOSROM is zeroed. BS games still load but lack the boot menu.

emulators/tic80.yml

@@ -30,13 +30,13 @@ platform_details:
   cartridge_format:
     extensions: "tic, png"
     source_ref: "tic80_libretro.c:339"
-    notes: |
+    note: |
       .tic is the native cartridge format. .png loads cartridges
       encoded as cover images (code stored in PNG metadata).
 
   runtime:
     source_ref: "nesbox/TIC-80 (submodule at core/)"
-    notes: |
+    note: |
       Entire runtime compiled into the binary. No external dependencies.
       State serialization uses TIC_PERSISTENT_SIZE * 4 bytes of pmem()
       data (tic80_libretro.c:1203-1243).

emulators/vecx.yml

@@ -39,7 +39,7 @@ platform_details:
   bios_mapping:
     target: "0xE000-0xFFFF in Vectrex address space (8 KB)"
     source_ref: "vecx.c:40 (unsigned char rom[8192]), vecx.c:437-439 (read handler)"
-    notes: |
+    note: |
       CPU reads from 0xE000-0xFFFF are served from rom[] via
       address & 0x1FFF masking. The array is populated from the
       compiled-in bios_data at retro_load_game() time.
@@ -58,7 +58,7 @@ platform_details:
       md5: "05f32c2b18b6fb168ab976989e86dfb1"
       sha1: "6c891bd74acb201d54071b310bd6df6617cdf205"
       size: 8192
-    notes: |
+    note: |
       All three variants are 8192 bytes, compiled as C arrays in
       bios/*.h headers. STANDARD_BIOS is the authentic Vectrex ROM.
       FAST_BIOS and skip are modified versions for faster startup.

emulators/vemulator.yml

@@ -43,7 +43,7 @@ platform_details:
       - "0x6E = 0xFF"
       - "P3 = 0xFF (no buttons pressed)"
       - "BCD date/time at 0x10-0x16, raw at 0x17-0x1D"
-    notes: |
+    note: |
       HLE skips the BIOS boot sequence and jumps directly into the loaded
       game. System clock, date, and button state are initialized in RAM.
       The EXT register is set to 1 to signal HLE mode to the CPU
@@ -56,7 +56,7 @@ platform_details:
     rom_load_size: 61440
     encryption: "XOR 0x37 after stripping 4-byte header"
     detection: "first byte 0x2A (JMPF) = unencrypted, otherwise encrypted"
-    notes: |
+    note: |
       The loadBIOS() method is fully implemented but unreachable from the
       libretro interface. No system directory query, no BIOS path construction,
       and no call site exists in main.cpp. A future update could wire this up

emulators/vice_x128.yml

@@ -25,28 +25,28 @@ files:
     description: "JiffyDOS C128 kernal replacement"
     required: false
     source_ref: "retrodep/ui.c:309-310"
-    notes: "Loaded into KernalIntName when vice_jiffydos option is enabled."
+    note: "Loaded into KernalIntName when vice_jiffydos option is enabled."
 
   - name: "JiffyDOS_C64.bin"
     description: "JiffyDOS C64 kernal replacement (GO64 mode)"
     required: false
     source_ref: "retrodep/ui.c:307-308"
-    notes: "Loaded into Kernal64Name when vice_jiffydos option is enabled."
+    note: "Loaded into Kernal64Name when vice_jiffydos option is enabled."
 
   - name: "JiffyDOS_1541-II.bin"
     description: "JiffyDOS 1541-II drive DOS replacement"
     required: false
     source_ref: "retrodep/ui.c:283-284"
-    notes: "Loaded into DosName1541ii when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1541ii when vice_jiffydos option is enabled."
 
   - name: "JiffyDOS_1571_repl310654.bin"
     description: "JiffyDOS 1571 drive DOS replacement"
     required: false
     source_ref: "retrodep/ui.c:285-286"
-    notes: "Loaded into DosName1571 when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1571 when vice_jiffydos option is enabled."
 
   - name: "JiffyDOS_1581.bin"
     description: "JiffyDOS 1581 drive DOS replacement"
     required: false
     source_ref: "retrodep/ui.c:287-288"
-    notes: "Loaded into DosName1581 when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1581 when vice_jiffydos option is enabled."

emulators/vice_x64.yml

@@ -25,31 +25,31 @@ files:
     description: "JiffyDOS C64 kernal replacement"
     required: false
     source_ref: "retrodep/ui.c:302-303"
-    notes: "Loaded into KernalName when vice_jiffydos option is enabled (non-SX64 models)."
+    note: "Loaded into KernalName when vice_jiffydos option is enabled (non-SX64 models)."
 
   - name: "JiffyDOS_SX-64.bin"
     description: "JiffyDOS SX-64 kernal replacement"
     required: false
     source_ref: "retrodep/ui.c:295-296"
-    notes: "Loaded into KernalName when vice_jiffydos option is enabled and SX-64 model selected."
+    note: "Loaded into KernalName when vice_jiffydos option is enabled and SX-64 model selected."
 
   - name: "JiffyDOS_1541-II.bin"
     description: "JiffyDOS 1541-II drive DOS replacement"
     required: false
     source_ref: "retrodep/ui.c:283-284"
-    notes: "Loaded into DosName1541ii when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1541ii when vice_jiffydos option is enabled."
 
   - name: "JiffyDOS_1571_repl310654.bin"
     description: "JiffyDOS 1571 drive DOS replacement"
     required: false
     source_ref: "retrodep/ui.c:285-286"
-    notes: "Loaded into DosName1571 when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1571 when vice_jiffydos option is enabled."
 
   - name: "JiffyDOS_1581.bin"
     description: "JiffyDOS 1581 drive DOS replacement"
     required: false
     source_ref: "retrodep/ui.c:287-288"
-    notes: "Loaded into DosName1581 when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1581 when vice_jiffydos option is enabled."
 
   - name: "kernal-901227-01.bin"
     description: "C64 Kernal Rev 1"
@@ -57,7 +57,7 @@ files:
     size: 8192
     validation: [size]
     source_ref: "vice/src/c64/c64-resources.c:253, vice/src/c64/c64model.c:131"
-    notes: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD NTSC model selected."
+    note: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD NTSC model selected."
 
   - name: "kernal-901227-02.bin"
     description: "C64 Kernal Rev 2"
@@ -65,4 +65,4 @@ files:
     size: 8192
     validation: [size]
     source_ref: "vice/src/c64/c64-resources.c:254, vice/src/c64/c64model.c:117"
-    notes: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD PAL model selected."
+    note: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD PAL model selected."

emulators/vice_x64dtv.yml

@@ -25,7 +25,7 @@ files:
     hle_fallback: true
     size: 2097152
     source_ref: "vice/src/c64dtv/c64dtvflash.c:59-64,470-471,488-505"
-    notes: >
+    note: >
       Loaded via sysfile_load from system/vice/C64DTV/. All model variants
       (V2 PAL/NTSC, V3 PAL/NTSC, Hummer) default to this filename. If not
       found, the core copies embedded BASIC, kernal and chargen ROMs into

emulators/vice_x64sc.yml

@@ -26,31 +26,31 @@ files:
     description: "JiffyDOS C64 kernal replacement"
     required: false
     source_ref: "retrodep/ui.c:302-303"
-    notes: "Loaded into KernalName when vice_jiffydos option is enabled (non-SX64 models)."
+    note: "Loaded into KernalName when vice_jiffydos option is enabled (non-SX64 models)."
 
   - name: "JiffyDOS_SX-64.bin"
     description: "JiffyDOS SX-64 kernal replacement"
     required: false
     source_ref: "retrodep/ui.c:295-296"
-    notes: "Loaded into KernalName when vice_jiffydos option is enabled and SX-64 model selected."
+    note: "Loaded into KernalName when vice_jiffydos option is enabled and SX-64 model selected."
 
   - name: "JiffyDOS_1541-II.bin"
     description: "JiffyDOS 1541-II drive DOS replacement"
     required: false
     source_ref: "retrodep/ui.c:283-284"
-    notes: "Loaded into DosName1541ii when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1541ii when vice_jiffydos option is enabled."
 
   - name: "JiffyDOS_1571_repl310654.bin"
     description: "JiffyDOS 1571 drive DOS replacement"
     required: false
     source_ref: "retrodep/ui.c:285-286"
-    notes: "Loaded into DosName1571 when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1571 when vice_jiffydos option is enabled."
 
   - name: "JiffyDOS_1581.bin"
     description: "JiffyDOS 1581 drive DOS replacement"
     required: false
     source_ref: "retrodep/ui.c:287-288"
-    notes: "Loaded into DosName1581 when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1581 when vice_jiffydos option is enabled."
 
   - name: "kernal-901227-01.bin"
     description: "C64 Kernal Rev 1"
@@ -58,7 +58,7 @@ files:
     size: 8192
     validation: [size]
     source_ref: "vice/src/c64/c64-resources.c:253, vice/src/c64/c64scmodel.c:141"
-    notes: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD NTSC model selected."
+    note: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD NTSC model selected."
 
   - name: "kernal-901227-02.bin"
     description: "C64 Kernal Rev 2"
@@ -66,4 +66,4 @@ files:
     size: 8192
     validation: [size]
     source_ref: "vice/src/c64/c64-resources.c:254, vice/src/c64/c64scmodel.c:123"
-    notes: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD PAL model selected."
+    note: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD PAL model selected."

emulators/vice_xscpu64.yml

@@ -29,7 +29,7 @@ files:
     max_size: 524288
     validation: [size]
     source_ref: "retrodep/ui.c:262-263, vice/src/scpu64/scpu64rom.c:75-89"
-    notes: "Loaded as SCPU64Name when SuperCPU Kernal option set to 2.04. Size must be power of 2 between 64 KB and 512 KB. Stored in system/vice/SCPU64/."
+    note: "Loaded as SCPU64Name when SuperCPU Kernal option set to 2.04. Size must be power of 2 between 64 KB and 512 KB. Stored in system/vice/SCPU64/."
 
   - name: "scpu-dos-1.4.bin"
     description: "CMD SuperCPU Kernal v1.4"
@@ -38,22 +38,22 @@ files:
     max_size: 524288
     validation: [size]
     source_ref: "retrodep/ui.c:265-266, vice/src/scpu64/scpu64rom.c:75-89"
-    notes: "Loaded as SCPU64Name when SuperCPU Kernal option set to 1.40. Size must be power of 2 between 64 KB and 512 KB. Stored in system/vice/SCPU64/."
+    note: "Loaded as SCPU64Name when SuperCPU Kernal option set to 1.40. Size must be power of 2 between 64 KB and 512 KB. Stored in system/vice/SCPU64/."
 
   - name: "JiffyDOS_1541-II.bin"
     description: "JiffyDOS 1541-II drive DOS replacement"
     required: false
     source_ref: "retrodep/ui.c:282-283"
-    notes: "Loaded as DosName1541ii when JiffyDOS option enabled."
+    note: "Loaded as DosName1541ii when JiffyDOS option enabled."
 
   - name: "JiffyDOS_1571_repl310654.bin"
     description: "JiffyDOS 1571 drive DOS replacement"
     required: false
     source_ref: "retrodep/ui.c:285-286"
-    notes: "Loaded as DosName1571 when JiffyDOS option enabled."
+    note: "Loaded as DosName1571 when JiffyDOS option enabled."
 
   - name: "JiffyDOS_1581.bin"
     description: "JiffyDOS 1581 drive DOS replacement"
     required: false
     source_ref: "retrodep/ui.c:287-288"
-    notes: "Loaded as DosName1581 when JiffyDOS option enabled."
+    note: "Loaded as DosName1581 when JiffyDOS option enabled."

emulators/vice_xvic.yml

@@ -25,7 +25,7 @@ files:
     size: 8192
     validation: [size]
     source_ref: "vice/src/vic20/vic20rom.h:49, vice/src/vic20/vic20model.c:60, vice/src/vic20/vic20rom.c:112-120"
-    notes: "Not embedded. Loaded via sysfile from system/vice/VIC20/ when VIC-1001 Japanese model selected via vicerc."
+    note: "Not embedded. Loaded via sysfile from system/vice/VIC20/ when VIC-1001 Japanese model selected via vicerc."
 
   - name: "chargen-901460-02.bin"
     description: "VIC-1001 Character ROM (Japanese)"
@@ -33,4 +33,4 @@ files:
     size: 4096
     validation: [size]
     source_ref: "vice/src/vic20/vic20rom.h:53, vice/src/vic20/vic20model.c:60, vice/src/vic20/vic20rom.c:173-179"
-    notes: "Not embedded. Loaded via sysfile from system/vice/VIC20/ when VIC-1001 Japanese model selected via vicerc."
+    note: "Not embedded. Loaded via sysfile from system/vice/VIC20/ when VIC-1001 Japanese model selected via vicerc."

emulators/vircon32.yml

@@ -47,7 +47,7 @@ files:
     md5: "73f04397cbb2dafcf2047b19a856153a"
     sha1: "67ddbcd018f03ed74b6e013074d92cc5f1f51c80"
     source_ref: "libretro.cpp:422-425"
-    notes: |
+    note: |
       Optional external BIOS placed in the system directory root.
       If present, overrides the embedded Standard BIOS v1.2.
       The hashes above correspond to the Standard BIOS v1.2 bundled
@@ -61,7 +61,7 @@ platform_details:
     file_size: 1073060
     md5: "73f04397cbb2dafcf2047b19a856153a"
     sha1: "67ddbcd018f03ed74b6e013074d92cc5f1f51c80"
-    notes: |
+    note: |
       The standard BIOS is compiled into the core binary as
       embedded_StandardBios[] via a generated header file. It provides
       the boot animation (Vircon32 logo + startup sound). LoadEmbeddedBios()
@@ -70,7 +70,7 @@ platform_details:
 
   bios_format:
     source_ref: "VirconDefinitions/FileFormats.hpp, V32Console.cpp:259-431"
-    notes: |
+    note: |
       A V32 BIOS ROM file must have:
       - BiosSignature in the header (distinct from CartridgeSignature)
       - Exactly 1 texture (boot screen graphics)
@@ -81,6 +81,6 @@ platform_details:
   cartridge_format:
     extensions: "v32"
     source_ref: "V32Console.cpp:468-696"
-    notes: |
+    note: |
       Cartridges use CartridgeSignature with up to 256 textures and
       1024 sounds. Program ROM can be up to 128M words (512 MB).

emulators/virtualjaguar.yml

@@ -111,7 +111,7 @@ analysis:
     source_ref: "libretro.c:902-904"
     selection_logic: "biosType == BT_K_SERIES ? jaguarBootROM : jaguarBootROM2"
     external_loading: false
-    notes: |
+    note: |
       jagBootPath and CDBootPath struct fields are never set in the libretro
       port. The standalone Virtual Jaguar GUI uses them but that code path
       is not compiled into the libretro core.

emulators/x64sdl.yml

@@ -46,7 +46,7 @@ files:
     size: 8192
     path: "data/C64/sxkernal"
     source_ref: "src/c64/c64model.c:142,147"
-    notes: "Loaded when SX64 PAL or SX64 NTSC model selected."
+    note: "Loaded when SX64 PAL or SX64 NTSC model selected."
 
   - name: "jpkernal"
     description: "Japanese C64 Kernal ROM"
@@ -54,7 +54,7 @@ files:
     size: 8192
     path: "data/C64/jpkernal"
     source_ref: "src/c64/c64model.c:152"
-    notes: "Loaded when C64 JAP NTSC model selected."
+    note: "Loaded when C64 JAP NTSC model selected."
 
   - name: "jpchrgen"
     description: "Japanese C64 character generator ROM"
@@ -62,7 +62,7 @@ files:
     size: 4096
     path: "data/C64/jpchrgen"
     source_ref: "src/c64/c64model.c:152"
-    notes: "Loaded when C64 JAP NTSC model selected."
+    note: "Loaded when C64 JAP NTSC model selected."
 
   - name: "gskernal"
     description: "C64 Games System Kernal ROM"
@@ -70,7 +70,7 @@ files:
     size: 8192
     path: "data/C64/gskernal"
     source_ref: "src/c64/c64model.c:157"
-    notes: "Loaded when C64 GS PAL model selected."
+    note: "Loaded when C64 GS PAL model selected."
 
   - name: "edkernal"
     description: "PET64/Educator64 Kernal ROM"
@@ -78,7 +78,7 @@ files:
     size: 8192
     path: "data/C64/edkernal"
     source_ref: "src/c64/c64model.c:162,167"
-    notes: "Loaded when PET64 PAL or PET64 NTSC model selected."
+    note: "Loaded when PET64 PAL or PET64 NTSC model selected."
 
   # IEC drive ROMs (optional, path: data/DRIVES/)
   - name: "dos1540"
@@ -86,14 +86,14 @@ files:
     required: false
     path: "data/DRIVES/dos1540"
     source_ref: "src/drive/iec/iecrom.c:99, src/drive/iec/iec-resources.c:182"
-    notes: "Hardware-level 1540 drive emulation. Absence disables this drive type."
+    note: "Hardware-level 1540 drive emulation. Absence disables this drive type."
 
   - name: "dos1541"
     description: "1541 floppy drive ROM"
     required: false
     path: "data/DRIVES/dos1541"
     source_ref: "src/drive/iec/iecrom.c:106, src/drive/iec/iec-resources.c:185"
-    notes: "Hardware-level 1541 drive emulation. Most common C64 drive."
+    note: "Hardware-level 1541 drive emulation. Most common C64 drive."
 
   - name: "d1541II"
     description: "1541-II floppy drive ROM"
@@ -124,14 +124,14 @@ files:
     required: false
     path: "data/DRIVES/dos2000"
     source_ref: "src/drive/iec/iecrom.c:139, src/drive/iec/iec-resources.c:195"
-    notes: "Not shipped with VICE 3.1 data files."
+    note: "Not shipped with VICE 3.1 data files."
 
   - name: "dos4000"
     description: "CMD FD-4000 drive ROM"
     required: false
     path: "data/DRIVES/dos4000"
     source_ref: "src/drive/iec/iecrom.c:145, src/drive/iec/iec-resources.c:197"
-    notes: "Not shipped with VICE 3.1 data files."
+    note: "Not shipped with VICE 3.1 data files."
 
   # IEEE drive ROMs (optional, path: data/DRIVES/)
   - name: "dos2031"
@@ -139,7 +139,7 @@ files:
     required: false
     path: "data/DRIVES/dos2031"
     source_ref: "src/drive/ieee/ieee.c:115, src/drive/ieee/ieee-resources.c:93"
-    notes: "IEEE488 interface drive. Requires parallel IEEE488 extension."
+    note: "IEEE488 interface drive. Requires parallel IEEE488 extension."
 
   - name: "dos2040"
     description: "2040 IEEE drive ROM"
@@ -171,11 +171,11 @@ files:
     required: false
     path: "data/PRINTER/mps803"
     source_ref: "src/printerdrv/drv-mps803.c:420"
-    notes: "Loaded on demand when MPS-803 printer opened."
+    note: "Loaded on demand when MPS-803 printer opened."
 
   - name: "nl10-cbm"
     description: "NL10 printer ROM"
     required: false
     path: "data/PRINTER/nl10-cbm"
     source_ref: "src/printerdrv/drv-nl10.c:2210"
-    notes: "Loaded on demand when NL10 printer opened."
+    note: "Loaded on demand when NL10 printer opened."

emulators/xemu.yml

@@ -21,7 +21,7 @@ files:
     size: 512
     source_ref: "hw/xbox/xbox.c:151 (bootrom_size != 512 -> error)"
     config_key: "sys.files.bootrom_path"
-    notes: |
+    note: |
       Overlaid on the last 512 bytes of the flash ROM region at boot.
       Mapped to 0xFFFFFE00-0xFFFFFFFF. Disabled after early init
       via LPC config register write (hw/xbox/xbox_pci.c:362).
@@ -34,7 +34,7 @@ files:
     size_note: "Must be a multiple of 64 KB. Default 256 KB."
     source_ref: "hw/xbox/xbox.c:70-81 (bios_name, bios_size validation)"
     config_key: "sys.files.flashrom_path"
-    notes: |
+    note: |
       Loaded as -bios argument (system/vl.c:3052-3053).
       Mapped to 0xFF000000-0xFFFFFFFF with mirroring.
       Common variants: Complex_4627 (1.0), Complex_4034 (debug),
@@ -47,7 +47,7 @@ files:
     size: 256
     source_ref: "system/vl.c:2939 (size != 256 -> error)"
     config_key: "sys.files.eeprom_path"
-    notes: |
+    note: |
       Loaded via smbus-storage device (hw/xbox/smbus_storage.c:157).
       Auto-generated as XBOX_EEPROM_VERSION_R1 if missing
       (system/vl.c:2918-2919). Default path: <config_dir>/eeprom.bin.
@@ -59,7 +59,7 @@ files:
     required: true
     source_ref: "system/vl.c:3060-3073 (hdd_path loading)"
     config_key: "sys.files.hdd_path"
-    notes: |
+    note: |
       Attached as IDE drive index=0 with locked=on.
       Must contain Xbox partitions (C, E, X, Y, Z).
       Pre-built images available from xemu project.

emulators/xrick.yml

@@ -59,7 +59,7 @@ files:
     md5: "a471e64e9f69afbe59c10cc94ed1b184"
     sha1: "ecfc092fe6371dbf38e238a8ba5f90785b5db52d"
     source_ref: "libretro-core.c:324-326 (path construction), libretro-core.c:328-357 (missing file error), libretro-core.c:359 (final path confirmation)"
-    notes: "Placed in system/xrick/data.zip. Contains sounds/ directory with 29 WAV files from the original xrick 0.21212 release. Without this file, standalone mode fails with 'XRick game files missing from frontend system directory'. Ships in the libretro repo root."
+    note: "Placed in system/xrick/data.zip. Contains sounds/ directory with 29 WAV files from the original xrick 0.21212 release. Without this file, standalone mode fails with 'XRick game files missing from frontend system directory'. Ships in the libretro repo root."
 
 analysis:
   content_type: game_engine

emulators/xroar.yml

@@ -41,7 +41,7 @@ files:
     validation: [crc32]
     aliases: [dragon32, d32rom, "Dragon Data Ltd - Dragon 32 - IC17"]
     source_ref: "xroar.c:643 (romlist d32), dragon.c:792,798-803,820-821 (load + CRC)"
-    notes: "Combined 16K ROM. Loaded into a single 16384-byte rombank slot."
+    note: "Combined 16K ROM. Loaded into a single 16384-byte rombank slot."
 
   # ---- Dragon 64 ----
 
@@ -54,7 +54,7 @@ files:
     validation: [crc32]
     aliases: [d64rom1, dragrom, "Dragon Data Ltd - Dragon 64 - IC17", "Dragon Data Ltd - TANO IC18", "Eurohard S.A. - Dragon 200 IC18"]
     source_ref: "xroar.c:641 (romlist d64_1), xroar.c:647 (romlist dragon64), dragon64.c:138-141,155-157 (load + CRC)"
-    notes: "IC17 ROM. Required for the machine to start."
+    note: "IC17 ROM. Required for the machine to start."
 
   - name: "d64_2.rom"
     system: dragon64
@@ -65,7 +65,7 @@ files:
     validation: [crc32]
     aliases: [d64rom2, "Dragon Data Ltd - Dragon 64 - IC18", "Dragon Data Ltd - TANO IC17", "Eurohard S.A. - Dragon 200 IC17"]
     source_ref: "xroar.c:642 (romlist d64_2), xroar.c:648 (romlist dragon64_alt), dragon64.c:146-152,160-162 (load + CRC)"
-    notes: "IC18 ROM. 64K mode alternate BASIC. Machine starts without it (32K mode only)."
+    note: "IC18 ROM. 64K mode alternate BASIC. Machine starts without it (32K mode only)."
 
   # ---- Dragon 200-E ----
 
@@ -78,7 +78,7 @@ files:
     validation: [crc32]
     aliases: [d200e_rom1, ic18_v1.4e.ic34]
     source_ref: "xroar.c:644 (romlist d200e_1), xroar.c:650 (romlist dragon200e), xroar.c:735 (crclist)"
-    notes: "Required for Dragon 200-E. Falls back to d64_1 then generic dragon if not found."
+    note: "Required for Dragon 200-E. Falls back to d64_1 then generic dragon if not found."
 
   - name: "d200e_2.rom"
     system: dragon64
@@ -87,7 +87,7 @@ files:
     size: 16384
     aliases: [d200e_rom2, ic17_v1.4e.ic37]
     source_ref: "xroar.c:645 (romlist d200e_2), xroar.c:651 (romlist dragon200e_alt)"
-    notes: "64K mode alternate. Falls back to d64_2 if not found."
+    note: "64K mode alternate. Falls back to d64_2 if not found."
 
   - name: "d200e_26.rom"
     system: dragon64
@@ -96,7 +96,7 @@ files:
     size: 4096
     aliases: [rom26.ic1]
     source_ref: "xroar.c:652 (romlist dragon200e_charset), dragon.c:523-539 (ext_charset load)"
-    notes: "Spanish character set. Loaded into a 4096-byte rombank. Machine works without it (uses standard charset)."
+    note: "Spanish character set. Loaded into a 4096-byte rombank. Machine works without it (uses standard charset)."
 
   # ---- Dragon Professional (Alpha) ----
 
@@ -108,7 +108,7 @@ files:
     validation: [crc32]
     aliases: [alpha_bt_10, "Dragon Data Ltd - Dragon Alpha Boot v1.0 150584"]
     source_ref: "xroar.c:654 (romlist dragonpro_boot), xroar.c:741 (crclist), dragonpro.c:231-234 (load)"
-    notes: "Required for Dragon Professional machine. Loaded as extbas_rom (boot ROM)."
+    note: "Required for Dragon Professional machine. Loaded as extbas_rom (boot ROM)."
 
   - name: "alpha-basic.rom"
     system: dragon64
@@ -116,7 +116,7 @@ files:
     required: true
     aliases: [alpha_ba, "Dragon Data Ltd - Dragon Alpga Basic"]
     source_ref: "xroar.c:655 (romlist dragonpro_basic), dragonpro.c:240-243 (load)"
-    notes: "Loaded as altbas_rom. Falls back to d64_1 if not found."
+    note: "Loaded as altbas_rom. Falls back to d64_1 if not found."
 
   # ---- Tandy CoCo (Colour BASIC) ----
 
@@ -128,7 +128,7 @@ files:
     crc32: "d8f4d15e"
     validation: [crc32]
     source_ref: "xroar.c:657 (romlist coco), xroar.c:747 (crclist bas13), dragon.c:807-812,824-826 (load + CRC)"
-    notes: "Default Colour BASIC. First tried in the @coco romlist. 8K ROM loaded into slot 1 of a 2-slot rombank."
+    note: "Default Colour BASIC. First tried in the @coco romlist. 8K ROM loaded into slot 1 of a 2-slot rombank."
 
   - name: "bas12.rom"
     system: coco
@@ -139,7 +139,7 @@ files:
     validation: [crc32]
     aliases: ["Color Basic v1.2 (1982)(Tandy)"]
     source_ref: "xroar.c:657 (romlist coco), xroar.c:746 (crclist bas12)"
-    notes: "Alternative to bas13. Second in fallback order."
+    note: "Alternative to bas13. Second in fallback order."
 
   - name: "bas11.rom"
     system: coco
@@ -149,7 +149,7 @@ files:
     crc32: "6270955a"
     validation: [crc32]
     source_ref: "xroar.c:657 (romlist coco), xroar.c:745 (crclist bas11)"
-    notes: "Used by CoCo 1E. Third in fallback order."
+    note: "Used by CoCo 1E. Third in fallback order."
 
   - name: "bas10.rom"
     system: coco
@@ -159,7 +159,7 @@ files:
     crc32: "00b50aaa"
     validation: [crc32]
     source_ref: "xroar.c:657 (romlist coco), xroar.c:744 (crclist bas10)"
-    notes: "Earliest version. Used by original CoCo 1. Last in fallback order."
+    note: "Earliest version. Used by original CoCo 1. Last in fallback order."
 
   # ---- Tandy CoCo (Extended Colour BASIC) ----
 
@@ -171,7 +171,7 @@ files:
     crc32: "a82a6254"
     validation: [crc32]
     source_ref: "xroar.c:658 (romlist coco_ext), xroar.c:752 (crclist extbas11), dragon.c:798-803,828-829 (load + CRC)"
-    notes: "Default Extended BASIC. 8K ROM loaded into slot 0 of a 2-slot rombank."
+    note: "Default Extended BASIC. 8K ROM loaded into slot 0 of a 2-slot rombank."
 
   - name: "extbas10.rom"
     system: coco
@@ -181,7 +181,7 @@ files:
     crc32: "e031d076"
     validation: [crc32]
     source_ref: "xroar.c:658 (romlist coco_ext), xroar.c:751 (crclist extbas10)"
-    notes: "Earlier version. Second in fallback order."
+    note: "Earlier version. Second in fallback order."
 
   # ---- Tandy CoCo 3 ----
 
@@ -193,7 +193,7 @@ files:
     crc32: "b4c88d6c"
     validation: [crc32]
     source_ref: "xroar.c:688 (romlist coco3), xroar.c:762 (crclist coco3), coco3.c:254-256,512-526 (load + CRC)"
-    notes: "32K combined ROM. Single required ROM for CoCo 3 NTSC."
+    note: "32K combined ROM. Single required ROM for CoCo 3 NTSC."
 
   - name: "coco3p.rom"
     system: coco3
@@ -201,7 +201,7 @@ files:
     required: true
     size: 32768
     source_ref: "xroar.c:689 (romlist coco3p), xroar.c:505,514 (machine config), coco3.c:254-256"
-    notes: "PAL variant of the CoCo 3 ROM. Required for PAL CoCo 3 machines."
+    note: "PAL variant of the CoCo 3 ROM. Required for PAL CoCo 3 machines."
 
   # ---- Tandy MC-10 ----
 
@@ -213,7 +213,7 @@ files:
     crc32: "11fda97e"
     validation: [crc32]
     source_ref: "xroar.c:695 (romlist mc10), xroar.c:767 (crclist mc10), mc10.c:157-158,397-407 (load + CRC)"
-    notes: "Single required ROM for MC-10."
+    note: "Single required ROM for MC-10."
 
   - name: "alice.rom"
     system: mc10
@@ -223,7 +223,7 @@ files:
     crc32: "f876abe9"
     validation: [crc32]
     source_ref: "xroar.c:697 (romlist alice), xroar.c:769 (crclist alice), mc10.c:157-158"
-    notes: "French Alice variant. Required for Alice machine. MC-10 compatible."
+    note: "French Alice variant. Required for Alice machine. MC-10 compatible."
 
   # ---- Deluxe CoCo (prototype) ----
 
@@ -235,7 +235,7 @@ files:
     validation: [crc32]
     aliases: [adv070_u24]
     source_ref: "xroar.c:673 (romlist deluxecoco), xroar.c:757 (crclist), deluxecoco.c:191-194 (load)"
-    notes: "Primary ROM for the Deluxe CoCo prototype. Loaded as extbas_rom."
+    note: "Primary ROM for the Deluxe CoCo prototype. Loaded as extbas_rom."
 
   - name: "adv071_u24.rom"
     system: coco
@@ -266,7 +266,7 @@ files:
     validation: [crc32]
     aliases: [mx1600bas_zephyr]
     source_ref: "xroar.c:679 (romlist mx1600), xroar.c:748 (crclist mx1600)"
-    notes: "Required for MX-1600. Zephyr-patched variant (CRC32 d11b1c96) is an alias."
+    note: "Required for MX-1600. Zephyr-patched variant (CRC32 d11b1c96) is an alias."
 
   - name: "mx1600extbas.rom"
     system: coco
@@ -301,28 +301,28 @@ files:
     description: "Tandy RS-DOS 1.1 (CoCo floppy disk controller)"
     required: false
     source_ref: "xroar.c:708 (romlist rsdos), rsdos.c:176 (default @rsdos)"
-    notes: "Primary CoCo disk controller ROM. disk10.rom (RS-DOS 1.0) is an earlier version used as fallback."
+    note: "Primary CoCo disk controller ROM. disk10.rom (RS-DOS 1.0) is an earlier version used as fallback."
 
   - name: "hdbdw3bck.rom"
     system: coco
     description: "RS-DOS with Becker port (DriveWire)"
     required: false
     source_ref: "xroar.c:718 (romlist rsdos_becker), xroar.c:572-574 (cart becker)"
-    notes: "For CoCo with Becker port hardware. Enables DriveWire connectivity."
+    note: "For CoCo with Becker port hardware. Enables DriveWire connectivity."
 
   - name: "ddos12a.rom"
     system: dragon64
     description: "DragonDOS 1.2a (Dragon floppy disk controller)"
     required: false
     source_ref: "xroar.c:702 (romlist dragondos), dragondos.c:173 (default @dragondos_compat)"
-    notes: "Latest DragonDOS version. Fallback chain tries DOSPlus -> SuperDOS -> DragonDOS -> Cumana. Older versions: ddos12, ddos40, ddos15, ddos10."
+    note: "Latest DragonDOS version. Fallback chain tries DOSPlus -> SuperDOS -> DragonDOS -> Cumana. Older versions: ddos12, ddos40, ddos15, ddos10."
 
   - name: "dplus49b.rom"
     system: dragon64
     description: "DOSPlus 4.9b (Dragon compatible DOS)"
     required: false
     source_ref: "xroar.c:703 (romlist dosplus)"
-    notes: "First tried in DragonDOS-compatible cartridge. Enhanced Dragon DOS. Older version: dplus48 (alias: dosplus-4.8, DOSPLUS)."
+    note: "First tried in DragonDOS-compatible cartridge. Enhanced Dragon DOS. Older version: dplus48 (alias: dosplus-4.8, DOSPLUS)."
 
   - name: "sdose6.rom"
     system: dragon64
@@ -330,7 +330,7 @@ files:
     required: false
     aliases: ["PNP - SuperDOS E6"]
     source_ref: "xroar.c:704 (romlist superdos)"
-    notes: "Latest SuperDOS. Older versions: sdose5, sdose4."
+    note: "Latest SuperDOS. Older versions: sdose5, sdose4."
 
   - name: "cdos20.rom"
     system: dragon64
@@ -345,14 +345,14 @@ files:
     required: false
     aliases: ["Premier Micros - DeltaDOS"]
     source_ref: "xroar.c:711 (romlist delta), deltados.c:160 (default @delta)"
-    notes: "Latest Delta version. Older versions: delta1a, delta19, delta, deltados."
+    note: "Latest Delta version. Older versions: delta1a, delta19, delta, deltados."
 
   - name: "cp450dsk.rom"
     system: coco
     description: "Prologica CP-450 DOS cartridge"
     required: false
     source_ref: "xroar.c:709 (romlist cp450)"
-    notes: "Falls back to RS-DOS if not found."
+    note: "Falls back to RS-DOS if not found."
 
   # ---- Other cartridge ROMs (all optional) ----
 
@@ -361,7 +361,7 @@ files:
     description: "Orchestra-90 CC sound cartridge ROM"
     required: false
     source_ref: "orch90.c:122 (default rom = orch90)"
-    notes: "Sound synthesis cartridge. Loaded directly (no romlist fallback)."
+    note: "Sound synthesis cartridge. Loaded directly (no romlist fallback)."
 
   - name: "mcx128.rom"
     system: mc10
@@ -369,7 +369,7 @@ files:
     required: false
     aliases: [MCX_Basic_21]
     source_ref: "xroar.c:724 (romlist mcx128), mcx128.c:208 (default @mcx128)"
-    notes: "128K memory expansion for MC-10. Adds enhanced BASIC."
+    note: "128K memory expansion for MC-10. Adds enhanced BASIC."
 
   - name: "mcx128a.rom"
     system: mc10
@@ -377,25 +377,25 @@ files:
     required: false
     aliases: [MCX_Basic_21_AZERTY]
     source_ref: "xroar.c:725 (romlist mcx128_azerty), xroar.c:632-633 (cart mcx128a)"
-    notes: "AZERTY keyboard variant for Alice. Same MCX128 hardware."
+    note: "AZERTY keyboard variant for Alice. Same MCX128 hardware."
 
   - name: "yados.rom"
     system: coco
     description: "YADOS (Glenside IDE interface ROM)"
     required: false
     source_ref: "xroar.c:690 (romlist glenside_ide), idecart.c:204 (default @glenside_ide)"
-    notes: "IDE hard disk interface. Fallback: hdblba.rom (alternative IDE ROM)."
+    note: "IDE hard disk interface. Fallback: hdblba.rom (alternative IDE ROM)."
 
   - name: "sdbdos.rom"
     system: dragon64
     description: "SDBDOS (MOOH memory cartridge ROM)"
     required: false
     source_ref: "mooh.c:254 (default rom = sdbdos)"
-    notes: "SD card boot DOS for MOOH cartridge. Loaded directly."
+    note: "SD card boot DOS for MOOH cartridge. Loaded directly."
 
   - name: "dragonfly-2.3.rom"
     system: dragon64
     description: "Ikon Ultra Drive Dragonfly ROM 2.3"
     required: false
     source_ref: "xroar.c:715 (romlist ikon), ikon.c:151 (default @ikon)"
-    notes: "Experimental. Ikon Ultra Drive storage interface. Older version: dragonfly-1.3."
+    note: "Experimental. Ikon Ultra Drive storage interface. Older version: dragonfly-1.3."