opencode
3bb4598d04
- 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)
40 lines
1.4 KiB
Markdown
40 lines
1.4 KiB
Markdown
|
||
# Bewerten
|
||
|
||
Auf der Detailseite eines Tools kannst du deine Erfahrung teilen. Klicke auf
|
||
**Bewertung abgeben** (erfordert ein Konto).
|
||
|
||
## Formularfelder
|
||
|
||
| Feld | Pflicht | Hinweise |
|
||
| --- | --- | --- |
|
||
| **Nützlichkeit** | Ja | 1–5 Sterne |
|
||
| **Bedienbarkeit** | Ja | 1–5 Sterne |
|
||
| **Kommentar** | Nein | Freitext |
|
||
| **Name** | Nein | Standard „Anonym" |
|
||
|
||
Neben den Feldern führt das **?‑Icon** direkt zur zugehörigen Feldbeschreibung
|
||
in der [Datenmodell-Referenz](/docs/reference/schemas/ratinginput).
|
||
|
||
## Was passiert nach dem Abgeben?
|
||
|
||
- Deine Bewertung wird sofort gespeichert und erscheint in der
|
||
**Bewertungsliste** der Detailseite.
|
||
- Die **Durchschnittswerte** (Nützlichkeit, Bedienbarkeit, Kombiniert) und die
|
||
**Punkteverteilung** werden aktualisiert.
|
||
- Die **Statistiken** im Bereich [Analytics](/docs/handbook/analytics) werden
|
||
neu berechnet.
|
||
|
||
## Statistik-Bereiche auf der Detailseite
|
||
|
||
- **Bewertungsübersicht:** Nützlichkeit & Bedienbarkeit als Durchschnitt mit
|
||
Fortschrittsbalken.
|
||
- **Punkteverteilung:** Anzahl der Bewertungen pro Stern (1★–5★).
|
||
- **Verlauf:** Linienchart der kombinierten/Teilwerte über die Zeit
|
||
(erst ab mehreren Bewertungen sichtbar).
|
||
|
||
## API
|
||
|
||
- [`POST /tools/{id}/ratings`](/docs/reference/endpoints/ratings#createRating) — Bewertung abgeben
|
||
- [`GET /tools/{id}/ratings`](/docs/reference/endpoints/ratings#listToolRatings) — Bewertungen eines Tools
|