# 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)