# v0.8.0 — Release Notes

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

## New features

- **Complete documentation site** in mkdocs look under `/docs`:
  - **Manual** with understandable explanations of all features
    (Getting started, creating a tool, evaluations, comparing, watchlist,
    analytics, administration, data model).
  - **Automatically generated reference** from `lib/api-spec/openapi.yaml`:
    all endpoints and data fields (type, required status, constraints) —
    this guarantees that *every* feature is documented.
  - **Search** across the manual, endpoints, and fields.
  - **Version dropdown**: older releases keep their full field/endpoint
    reference as a snapshot.
  - **Repo link** to the source in the top right.
- **Help buttons (?) in forms** (NetBox style): next to each field,
  an icon jumps directly to the field description in the docs.

## Fixes & improvements

- Docs generator `scripts/src/generate-docs.mjs` replaces the previous
  `sync-release-docs.mjs` (OpenAPI parsing, manual, search index, snapshots).
- Documentation for v0.7.0 backfilled.

## API changes

- No breaking changes to the API.

## Operations / upgrade

- **Env vars:** unchanged.
- **Migration:** none.
- **Breaking changes:** none.

## Known limitations

- Manual & reference apply to the current version; older versions
  show their release notes and a reference snapshot, if generated at
  release time (`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)