6c92b6358d
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
1.5 KiB
1.5 KiB
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 (1–5 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}/ratingsabrufbar. - Der Rating-Verlauf über die Zeit ist über
GET /tools/{id}/rating-historyeinsehbar (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 (1–5) | Nützlichkeitsbewertung. |
usability |
integer (1–5) | Bedienbarkeitsbewertung. |
comment |
string? | Optionaler Kommentar. |
reviewerName |
string? | Optionaler Anzeigename des Bewerters. |
createdAt |
date-time | Zeitpunkt der Bewertung. |