admin/tool-evaluator
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a65e2eb92c45cb1611e5a25b4d860b74e1f16831
tool-evaluator/docs/releases/v0.8.0.md
T
opencode 3bb4598d04 feat(docs): version-based docs, correct Gitea tag links, form guide help 
- 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)
2026-08-04 07:31:47 +02:00

1.7 KiB
Raw Blame History

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

Links

Reference in New Issue View Git Blame Copy Permalink