# v0.8.0 — Release Notes

**Datum:** 2026-08-03 · **Tag:** [`v0.8.0`](https://git.kubebase.de/admin/tool-evaluator/tags/v0.8.0)

## Neue Features

- **Vollständige Dokumentations-Site** in mkdocs-Optik unter `/docs`:
  - **Handbuch** mit verständlichen Erklärungen zu allen Features
    (Erste Schritte, Tool anlegen, Bewertungen, Vergleichen, Watchlist,
    Analytics, Administration, Datenmodell).
  - **Automatisch generierte Referenz** aus `lib/api-spec/openapi.yaml`:
    alle Endpunkte und Datenfelder (Typ, Pflichtstatus, Constraints) —
    damit ist garantiert, dass *jedes* Feature dokumentiert ist.
  - **Suche** über Handbuch, Endpunkte und Felder.
  - **Versions-Dropdown**: ältere Releases behalten ihre vollständige
    Feld-/Endpunkt-Referenz als Snapshot.
  - **Repo-Link** oben rechts zur Quelle.
- **Hilfe-Buttons (?) in Formularen** (NetBox-Stil): neben jedem Feld
  springt ein Icon direkt zur Feldbeschreibung in der Doku.

## Fixes & Verbesserungen

- Doku-Generator `scripts/src/generate-docs.mjs` ersetzt den bisherigen
  `sync-release-docs.mjs` (OpenAPI-Parsing, Handbuch, Suchindex, Snapshots).
- Dokumentation für v0.7.0 nachgezogen.

## API-Änderungen

- Keine Breaking Changes an der API.

## Betrieb / Upgrade

- **Env-Vars:** unverändert.
- **Migration:** keine.
- **Breaking Changes:** keine.

## Bekannte Einschränkungen

- Handbuch & Referenz gelten für die aktuelle Version; ältere Versionen
  zeigen ihre Release-Notes und einen Referenz-Snapshot, sofern beim Release
  erzeugt (`node scripts/src/generate-docs.mjs --snapshot vX.Y.Z`).

## Links

- Commit: [`6c92b63`](https://git.kubebase.de/admin/tool-evaluator/commit/6c92b63)
- Tag: [`v0.8.0`](https://git.kubebase.de/admin/tool-evaluator/tags/v0.8.0)