From 536093f6c9b0248ec8768bfa42e5dd9a152fc1b4 Mon Sep 17 00:00:00 2001 From: Torben Nehmer Date: Wed, 16 Sep 2026 17:56:04 +0200 Subject: [PATCH] docs: INSTALL.md/EVALS.md ziehen nach, dass version notes den Feed mitfragt (#107) Nachzug aus der Abschlussphase. INSTALL.md behauptete, version check sei der einzige Befehl, der ins Netz geht - seit 6.1.0-beta.4 sind es zwei. EVALS.md nennt version notes als dritten Nutzer der Stamp-Unterscheidung Instanz/Dev-Checkout, die genau diese Fallback-Grenze traegt. Prosa-only, ausserhalb des CI-Version-Gates, deshalb kein Bump. Files changed: - EVALS.md - INSTALL.md --- EVALS.md | 4 ++-- INSTALL.md | 9 ++++++--- 2 files changed, 8 insertions(+), 5 deletions(-) diff --git a/EVALS.md b/EVALS.md index 250fc64..3aee6fd 100644 --- a/EVALS.md +++ b/EVALS.md @@ -202,8 +202,8 @@ same question the same way: | Git clone of this repo (dev checkout) | **on** (opt-out) | No `.wikitool-release.json` | | `dist export` tarball (a distributed instance) | **off** (opt-in) | `.wikitool-release.json` present | -The form is read off `.wikitool-release.json`, the same stamp `version check` and `dist upgrade` -already use to tell a distribution from the repo it came from - present means an operator never +The form is read off `.wikitool-release.json`, the same stamp `version check`, `dist upgrade` and +`version notes` already use to tell a distribution from the repo it came from - present means an operator never asked for telemetry, absent means this is the dev checkout the stack ships from, where the traces are its own measuring instrument (the rest of this file). A private instance (`instructions/private-instance.md`) is a git clone of an *export*, so it carries the stamp and diff --git a/INSTALL.md b/INSTALL.md index 989675e..1eaf946 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -152,9 +152,12 @@ tools/wikitool version # was läuft hier, und woher kommt es tools/wikitool version check # gibt es ein neueres Release? ``` -`version check` ist der einzige Befehl, der ins Netz geht. Er fragt den Release-Feed der -Ursprungs-Instanz (`$WIKITOOL_UPDATE_URL` überschreibt; sonst der Wert aus dem Stamp). Ein -nicht erreichbarer Feed wird als Fehler gemeldet - **nie** als „aktuell". +`version check` und `version notes` sind die einzigen Befehle, die ins Netz gehen, und beide +fragen denselben Release-Feed der Ursprungs-Instanz (`$WIKITOOL_UPDATE_URL` überschreibt; sonst +der Wert aus dem Stamp). `version check` ist dafür da; `version notes` greift nur dann darauf +zurück, wenn die lokale `CHANGES.md` den Eintrag nicht hat - auf einer Instanz also immer, siehe +unten - und sagt vorher auf stderr, welche URL es fragt. Ein nicht erreichbarer Feed wird als +Fehler gemeldet - **nie** als „aktuell" und nie als „keine Notes". **Was die Versionsnummer aussagt:** kompatibel ist, was in der *linkesten von Null verschiedenen Stelle* übereinstimmt. `0.1.3 → 0.1.4` ist ein sicheres Update, `0.1.3 → 0.2.0`