opencode
6eb3dfd8f9
- Remove all prior release notes and version snapshots (v0.6.0-v0.8.6) - Rename handbook to *.de.md; keep *.en.md - New release notes v0.9.0.de.md/.en.md with v0.9.0 snapshot - generate-docs.mjs: .de/.en convention incl. search index and en-fallback - docs.tsx: release fallback now uses version.de.md - Wording: neutral tagline, anonymous user, no gender forms - Add docs/examples/import-tools.yaml and link from administration docs
40 lines
1.3 KiB
Markdown
40 lines
1.3 KiB
Markdown
|
||
# Rating
|
||
|
||
On the detail page of a tool you can share your experience. Click on
|
||
**Submit a rating** (requires an account).
|
||
|
||
## Form fields
|
||
|
||
| Field | Required | Notes |
|
||
| --- | --- | --- |
|
||
| **Usefulness** | Yes | 1–5 stars |
|
||
| **Usability** | Yes | 1–5 stars |
|
||
| **Comment** | No | Free text |
|
||
| **Name** | No | Defaults to "Anonymous" |
|
||
|
||
Next to the fields, the **? icon** links directly to the associated field
|
||
description in the [data model reference](/docs/reference/schemas/ratinginput).
|
||
|
||
## What happens after submitting?
|
||
|
||
- Your rating is saved immediately and appears in the **rating list** of the
|
||
detail page.
|
||
- The **averages** (usefulness, usability, combined) and the **score
|
||
distribution** are updated.
|
||
- The **statistics** in the [Analytics](/docs/handbook/analytics) section are
|
||
recalculated.
|
||
|
||
## Statistic sections on the detail page
|
||
|
||
- **Rating overview:** usefulness & usability as an average with progress
|
||
bars.
|
||
- **Score distribution:** number of ratings per star (1★–5★).
|
||
- **History:** line chart of combined/individual values over time
|
||
(only visible once there are several ratings).
|
||
|
||
## API
|
||
|
||
- [`POST /tools/{id}/ratings`](/docs/reference/endpoints/ratings#createRating) — Submit a rating
|
||
- [`GET /tools/{id}/ratings`](/docs/reference/endpoints/ratings#listToolRatings) — Ratings of a tool
|