Files
tool-evaluator/docs/handbook/bewertungen.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.5 KiB
Raw Blame History

title, order
title order
Bewertungen 4

Bewertungen

Bewertungen sind das Herz von toolr: Sie zeigen, wie nützlich und wie gut bedienbar ein Tool in den Augen der Community ist.

Wie funktioniert die Bewertung?

Auf der Detailseite eines Tools vergibst du zwei Werte (15 Sterne):

  • Nützlichkeit — Wie gut löst das Tool sein Kernproblem?
  • Bedienbarkeit — Wie einfach ist es zu bedienen?

Optional kannst du einen Kommentar und deinen Namen hinterlassen. Die Eingabefelder entsprechen dem Schema RatingInput.

Was passiert mit meiner Bewertung?

  • Deine Bewertung wird sofort gespeichert und in den Durchschnittswerten des Tools berücksichtigt.
  • Jede Bewertung ist über GET /tools/{id}/ratings abrufbar.
  • Der Rating-Verlauf über die Zeit ist über GET /tools/{id}/rating-history einsehbar (grafisch auf der Detailseite).

Datenfelder

Eine Bewertung besteht aus diesen Feldern (Rating):

Feld Typ Bedeutung
id integer Eindeutige ID der Bewertung.
toolId integer ID des bewerteten Tools.
usefulness integer (15) Nützlichkeitsbewertung.
usability integer (15) Bedienbarkeitsbewertung.
comment string? Optionaler Kommentar.
reviewerName string? Optionaler Anzeigename des Bewerters.
createdAt date-time Zeitpunkt der Bewertung.