From 9253a16fedb9cc46187359825e760dd08afc3113 Mon Sep 17 00:00:00 2001 From: Duncan Tourolle Date: Sat, 26 Sep 2026 07:45:57 -0400 Subject: [PATCH] Say which packages carry the manual, and that NFR-R8 is decided distribution.md's list of what every channel must get right had the face models as the one LFS trap. Since 0.15.0 (d8f26fb) the Arch package, the Windows installer and the APK also carry the rendered manual and its pictures, and refuse LFS pointers for the same reason; the Flatpak manifest does not install it. The Vulkan bullet still called NFR-R8 open. It was decided on 2026-09-19: no CPU pipeline, and a viewer on embedded previews with develop and export withheld. --- docs/dev/distribution.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/dev/distribution.md b/docs/dev/distribution.md index cd66dc2..8cce5b3 100644 --- a/docs/dev/distribution.md +++ b/docs/dev/distribution.md @@ -45,10 +45,11 @@ somewhere: `project_license` is GPL-3.0-or-later; those differ on purpose — see the comment in the file. - **Vulkan is a requirement, not a preference.** The develop pipeline is - compute shaders through wgpu, and NFR-R8 — how far a CPU fallback goes — is - still open, so today there is nothing behind it. A package that installs onto - a machine with no working ICD produces an application that starts and cannot - develop. + compute shaders through wgpu, and NFR-R8 was decided on 2026-09-19 against a + CPU pipeline: without a device the library, the grid and the judgements work + on embedded previews, and develop and export say they are unavailable. A + package that installs onto a machine with no working ICD produces an + application that starts and cannot develop. - **A Secret Service implementation, or an honest degraded mode.** FR-NC-2 is explicit that the absence of a secrets daemon is a stated degraded mode and never a silent fall back to plaintext. Packages express this as an optional @@ -59,6 +60,12 @@ somewhere: the Flatpak manifest check the file size and refuse, because the alternative is a package whose face indexing fails inside the graph loader on a user's machine rather than on the packager's. +- **So are the manual's pictures.** Since 0.15.0 the Arch package, the Windows + installer and the APK carry `docs/manual/index.html` and its `media/`, where + `dr_ui::manual` looks for them (`/usr/share/darkroom/manual`, `manual\` beside + `darkroom.exe`, the APK's `assets/manual`), and each refuses a pointer where a + picture should be — shipped, a pointer is a manual of broken images that + nothing reports. The Flatpak manifest does not install it yet. ---