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`