opencode
3bb4598d04
- each release now carries a full docs snapshot (reference + handbook) under docs/releases/<v>/; the docs frontend loads a version's snapshot for /docs/vX.Y.Z/* and shows the handbook/reference of that version - version dropdown navigates to /docs/<version> (docs home) instead of the release notes page; old /docs/vX.Y.Z redirect removed - generator: --snapshot writes handbook + reference; build copies versioned snapshots (last 7 versions) into /docs/versions/<v>/ - fix Gitea tag links: /admin/tool-evaluator/tags/<v> was 404, correct URL is /releases/tag/<v> - add GuideHelp button to forms/pages linking to the matching handbook guide (rating, tool add/edit, costs, compare, watchlist, analytics)
47 lines
1.7 KiB
Markdown
47 lines
1.7 KiB
Markdown
# v0.8.0 — Release Notes
|
|
|
|
**Datum:** 2026-08-03 · **Tag:** [`v0.8.0`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/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/releases/tag/v0.8.0)
|