update docs

docs/developer/README.md

@@ -0,0 +1,80 @@
+# Developer notes
+
+This is the engineering side of FDS: how the pieces are built, why choices were
+made, and what we actually measured. The [user manual](../README.md) describes
+how to use the current interfaces without the milestone history.
+
+Start with [the active cartridge/desktop revision](current-revision.md). Its
+acceptance is separate from the frozen 0.1.0 release. Old test reports describe
+the inputs named in those reports; a changed source tree needs fresh checks.
+
+## Design and build references
+
+- [Master plan](master-plan.md)
+- [Build host and dependencies](build-host.md)
+- [Development workflow](development.md)
+- [Workstation tooling plan](workstation-tooling-plan.md)
+- [Architecture](architecture.md), [packages](packages.md), [rootfs](rootfs.md), [init](init.md), [services](services.md)
+- [Reproducible builds and frozen releases](reproducible-builds.md)
+- [Dasung integration and physical monitor procedure](dasung.md)
+- [Physical bay calibration and stress procedures](stress-testing.md)
+- [Implementation ledger](implementation-status.md) and [roadmap](roadmap.md)
+
+## Acceptance history
+
+- [clap-validation](clap-validation.md)
+- [dasung-validation](dasung-validation.md)
+- [m0-validation](m0-validation.md)
+- [m1-validation](m1-validation.md)
+- [m10-validation](m10-validation.md)
+- [m11-validation](m11-validation.md)
+- [m12-validation](m12-validation.md)
+- [m2-validation](m2-validation.md)
+- [m3-validation](m3-validation.md)
+- [m4-validation](m4-validation.md)
+- [m5-validation](m5-validation.md)
+- [m6-validation](m6-validation.md)
+- [m7-validation](m7-validation.md)
+- [m8-validation](m8-validation.md)
+- [m9-validation](m9-validation.md)
+- [workstation-validation](workstation-validation.md)
+
+## Earlier guides and working notes
+
+These retain useful implementation details and the historical interfaces that
+went with them. Use the user manual for current commands, especially software
+cartridge creation: new payloads contain installed Void package trees.
+
+- [architecture](architecture.md)
+- [boot](boot.md)
+- [build-host](build-host.md)
+- [cartridges](cartridges.md)
+- [cleanup](cleanup.md)
+- [dasung](dasung.md)
+- [data](data.md)
+- [desktop](desktop.md)
+- [development](development.md)
+- [eeprom](eeprom.md)
+- [getting-started](getting-started.md)
+- [glossary](glossary.md)
+- [implementation-status](implementation-status.md)
+- [init](init.md)
+- [internal-storage](internal-storage.md)
+- [m4-work](m4-work.md)
+- [master-plan](master-plan.md)
+- [media-tools](media-tools.md)
+- [packages](packages.md)
+- [performance](performance.md)
+- [power](power.md)
+- [recovery](recovery.md)
+- [releases](releases.md)
+- [reproducible-builds](reproducible-builds.md)
+- [roadmap](roadmap.md)
+- [rootfs](rootfs.md)
+- [services](services.md)
+- [software-format](software-format.md)
+- [stress-testing](stress-testing.md)
+- [tooling](tooling.md)
+- [troubleshooting](troubleshooting.md)
+- [workstation-tooling-plan](workstation-tooling-plan.md)
+- [workstation](workstation.md)