docs: add v0.8.3 release notes

2026-08-04 07:32:14 +02:00
parent 3bb4598d04
commit b886246808
1 changed files with 49 additions and 0 deletions
@@ -0,0 +1,49 @@
+# v0.8.3 — Release Notes
+
+**Datum:** 2026-08-04 · **Tag:** [`v0.8.3`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.8.3)
+
+## Neue Features
+
+- **Versionsbasierte Dokumentation**: Jedes Release trägt jetzt einen
+  vollständigen Doku-Snapshot (Handbuch + API-Referenz). Über das
+  Versions-Dropdown gelangst du zur Doku der jeweiligen Version
+  (`/docs/vX.Y.Z/…`) — inklusive Handbuch und Referenz, wie sie zum
+  Release-Zeitpunkt galten. Die letzten 7 Versionen bleiben verfügbar.
+- **Hilfe-Buttons in Formularen (NetBox-Stil)**: Bei Bewertung, Tool
+  anlegen/bearbeiten, Kosten, Vergleichen, Watchlist und Analytics gibt es
+  jetzt ein Hilfe-Icon, das direkt zur passenden Anleitung im Handbuch führt.
+
+## Fixes & Verbesserungen
+
+- **Gitea-Tag-Links korrigiert**: `…/tags/vX.Y.Z` war eine 404-Seite; die
+  korrekte URL lautet `/releases/tag/vX.Y.Z` (in allen Release-Notes und der
+  Doku-Seite).
+- Versions-Wechsel führt jetzt zur Doku der gewählten Version statt direkt
+  nur zur Release-Seite; alte `/docs/vX.Y.Z`-Redirects entfallen.
+- Doku-Generator: `--snapshot` erzeugt Handbuch + Referenz pro Version; beim
+  Build werden die Snapshots der letzten 7 Versionen eingespielt.
+
+## API-Änderungen
+
+- Keine Änderungen an der API.
+
+## Betrieb / Upgrade
+
+- **Env-Vars:** unverändert.
+- **Migration:** keine.
+- **Breaking Changes:** keine. Neue Release-Notes müssen den korrekten
+  Tag-Link verwenden (siehe `docs/releases/TEMPLATE.md`). Für Versionen vor
+  diesem Release können Snapshots nachträglich erzeugt werden:
+  `node scripts/src/generate-docs.mjs --snapshot vX.Y.Z`.
+
+## Bekannte Einschränkungen
+
+- Ältere Releases ohne Snapshot (z. B. v0.6.0) zeigen nur ihre Release-Notes,
+  kein Handbuch/keine Referenz. Mit `--snapshot` nachpflegen.
+- Die Doku-Version entspricht dem Doku-Stand zum Zeitpunkt der Erstellung des
+  Snapshots; Änderungen am Handbuch gelten ab dem jeweils nächsten Release.
+
+## Links
+
+- Commit: [`<short-sha>`](https://git.kubebase.de/admin/tool-evaluator/commit/<short-sha>)
+- Tag: [`v0.8.3`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.8.3)