From 6dbb34167ce3638df8b63aae2876a12566125890 Mon Sep 17 00:00:00 2001
From: _ov4 <ov4@ov4.org>
Date: Thu, 22 Oct 2026 10:32:16 +0000
Subject: docs: describe latest nightly asset names and per-product versions

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 doc/install.md   | 7 ++++---
 plugin/README.md | 6 +++---
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/doc/install.md b/doc/install.md
index 9b59ee1..e006429 100644
--- a/doc/install.md
+++ b/doc/install.md
@@ -2,7 +2,7 @@
 
 To build from source, follow [build.md](build.md). For command-line usage, see [cpsc.1.md](cpsc.1.md). Run build commands from the project root; package installation commands run from the extracted package directory.
 
-The [Nightly Build](https://github.com/ovfor4/cie-pseudocode-compiler/releases/tag/nightly-build) provides EMBEDDED release archives for Linux x86_64, Windows x86_64 and macOS 15+ Apple Silicon, plus the VS Code extension. The macOS archive is named `cpsc-VERSION-Darwin-arm64.tar.xz`; use the Unix release package instructions below after extraction. For Windows, download `cpsc-VERSION-Windows-ARCH.zip` and follow the Windows release package instructions below; no LLVM or MSYS2 installation is required to run it.
+The [Nightly Build](https://github.com/ovfor4/cie-pseudocode-compiler/releases/tag/nightly-build) provides EMBEDDED release archives for Linux x86_64, Windows x86_64 and macOS 15+ Apple Silicon, plus the VS Code extension. The Nightly Build assets use the stable name `latest` in place of the version (`cpsc-latest-Linux-x86_64.tar.xz`, `cpsc-latest-Darwin-arm64.tar.xz`); `version.json` lists each product's commit time and commit. The extracted folder keeps the versioned name (`cpsc-<time>-<commit>-<Platform>`). For macOS, use the Unix release package instructions below after extraction. For Windows, download `cpsc-latest-Windows-ARCH.zip` and follow the Windows release package instructions below; no LLVM or MSYS2 installation is required to run it.
 
 ## Linux installation
 
@@ -77,8 +77,9 @@ Create an installation archive with:
 make -C build release
 ```
 
-The output is `build/cpsc-VERSION-SYSTEM-ARCH.tar.xz`. `VERSION` uses HEAD's commit
-time in UTC followed by its short ID: `yyyymmdd-hhmmss-commit`.
+The output is `build/cpsc-VERSION-SYSTEM-ARCH.tar.xz`. `VERSION` uses the UTC time
+and short ID of the last commit that changed the compiler sources (the paths in
+`cmake/CompilerPaths.txt`), not HEAD: `yyyymmdd-hhmmss-commit`.
 The version is read each time packaging runs. The package uses the current build's
 execution mode and contains `cpsc`, `doc/cpsc.1`, `doc/language/**/*.7`, `install.sh` and `LICENSE`.
 Packaging builds the compiler and manual automatically; it requires Git and Pandoc.
diff --git a/plugin/README.md b/plugin/README.md
index 88ddd4c..48738dc 100644
--- a/plugin/README.md
+++ b/plugin/README.md
@@ -6,14 +6,14 @@ VS Code support for this project's `.cps` files. Requires VS Code 1.85 or newer
 
 ## Install
 
-Download the VSIX from [Nightly Build](https://github.com/ovfor4/cie-pseudocode-compiler/releases/tag/nightly-build). The same release provides Linux x86_64, Windows x86_64 and macOS 15+ Apple Silicon compiler packages with execution support.
+Download `cpsc-plugin-latest.vsix` from [Nightly Build](https://github.com/ovfor4/cie-pseudocode-compiler/releases/tag/nightly-build). The same release provides Linux x86_64, Windows x86_64 and macOS 15+ Apple Silicon compiler packages with execution support.
 
 If you installed the old extension (`ovfor4.cie-pseudocode`), uninstall it before installing `ovfor4.plugin`. Update any explicit `editor.defaultFormatter` setting to `ovfor4.plugin`.
 
-In the Extensions panel, choose **... > Install from VSIX...** and select the downloaded `cpsc-plugin-<date>-<time>-<commit>.vsix` (for example, `cpsc-plugin-20261018-054123-1b0b287.vsix`), or run:
+In the Extensions panel, choose **... > Install from VSIX...** and select the downloaded `cpsc-plugin-latest.vsix`, or run:
 
 ```sh
-code --install-extension cpsc-plugin-20261018-054123-1b0b287.vsix
+code --install-extension cpsc-plugin-latest.vsix
 ```
 
 Open a `.cps` file. The language mode should show **CIE Pseudocode**.
-- 
cgit v1.3.1-4-g156e