From e72f13e78a042b57128fb263457d8c14acd4da0e Mon Sep 17 00:00:00 2001
From: Jared Miller <jared@smell.flowers>
Date: Tue, 10 Feb 2026 17:08:49 -0500
Subject: [PATCH] Add provenance documentation for test story files

---
 content/stories/README.txt | 52 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 content/stories/README.txt

diff --git a/content/stories/README.txt b/content/stories/README.txt
new file mode 100644
index 0000000..5d0b380
--- /dev/null
+++ b/content/stories/README.txt
@@ -0,0 +1,52 @@
+z-machine story files
+=====================
+
+story files used for interpreter compatibility testing.
+binary files are gitignored (*.z* pattern).
+
+zork1.z3
+  author: Infocom (Marc Blank, Dave Lebling)
+  version: 3 (V3)
+  notes: classic Infocom title, used for initial interpreter development
+
+LostPig.z8
+  author: Admiral Jota (Grunk)
+  version: 8 (V8)
+  source: https://ifarchive.org/if-archive/games/zcode/LostPig.z8
+  license: freeware
+  notes: modern Inform game, used for V5/V8 opcode development
+
+curses.z5
+  author: Graham Nelson
+  version: 5 (V5)
+  source: https://ifarchive.org/if-archive/games/zcode/curses.z5
+  license: freeware
+  notes: first Inform game (1993), exercises many opcodes
+
+photopia.z5
+  author: Adam Cadre
+  version: 5 (V5)
+  source: https://ifarchive.org/if-archive/games/zcode/photopia.z5
+  license: freeware
+  notes: narrative-heavy, triggered op_set_colour implementation
+
+Tangle.z5
+  author: Andrew Plotkin
+  version: 5 (V5)
+  source: https://ifarchive.org/if-archive/games/zcode/Tangle.z5
+  license: freeware
+  notes: "Spider and Web" - clever parser tricks, unreliable narrator
+
+shade.z5
+  author: Andrew Plotkin
+  version: 5 (V5)
+  source: https://ifarchive.org/if-archive/games/zcode/shade.z5
+  license: freeware
+  notes: small atmospheric game, good smoke test
+
+anchor.z8
+  author: Michael Gentry
+  version: 8 (V8)
+  source: https://ifarchive.org/if-archive/games/zcode/anchor.z8
+  license: freeware (original z-machine version)
+  notes: "Anchorhead" - horror, heavy object manipulation, largest test game