update docs

2026-09-22 13:23:34 +08:00
parent 99bc3d15c5
commit 8a4788fca8
126 changed files with 7198 additions and 2425 deletions
@@ -0,0 +1,24 @@
+# Workstation tooling plan
+
+The current source of requirements is [the active revision](current-revision.md).
+The public tools remain native Linux Clap applications: `fds-cartridge` and
+`fds-emulator`. Full OS cross builds keep their separate pinned Void environment.
+
+New software creation uses Void source templates and `xbps-src`. The image builder
+installs packages and dependencies on the workstation, verifies installed trees,
+and writes them directly into EROFS program partitions with format-2 metadata.
+Creation no longer generates xz software bundles. Legacy readers stay available.
+
+The emulator still uses actual FDS ARM kernel/userspace, twelve virtual USB bays,
+read-only SYSTEM/PROGRAM disks, private writable DATA overlays, the public serial
+console, safe eject, forced removal and native shutdown. Hardware timing and
+physical behavior require the procedures in the hardware notes.
+
+Acceptance must cover real source-package builds, image integrity and write/readback,
+foreground PATH commands and terminal behavior, background `fds run`, eject/unplug,
+service restart and the rendered X11 control panel. Keep the frozen 0.1.0 release
+unchanged. Build new matching artifacts and record their hashes and source inputs.
+
+See [user instructions](../workstation.md) and [format reference](../software-format.md)
+for the supported interface. Historical xz acceptance remains in
+[the earlier workstation record](workstation-validation.md).