Files
tool-evaluator/docs/releases/v0.8.0.md
T
opencode 6c92b6358d feat(docs): mkdocs-style documentation site served at /docs
Full documentation hub replacing the release-notes-only view:
- Handbook pages (docs/handbook) for all features and admin/betrieb
- API reference generated from lib/api-spec/openapi.yaml via
  scripts/src/generate-docs.mjs (replaces sync-release-docs.mjs):
  endpoints, schemas/fields, search index, per-release snapshots
- mkdocs layout: sidebar nav, right TOC with scrollspy, search overlay,
  version dropdown, repo link
- FieldHelp (?) buttons in forms linking to reference field docs
- v0.7.0 release notes backfilled, v0.8.0 release notes added
2026-08-03 22:15:54 +02:00

1.7 KiB

v0.8.0 — Release Notes

Datum: 2026-08-03 · 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).