Files
tool-evaluator/docs/releases/v0.8.1/handbook/getting-started.md
T
opencode 3bb4598d04 feat(docs): version-based docs, correct Gitea tag links, form guide help
- 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)
2026-08-04 07:31:47 +02:00

1.9 KiB
Raw Blame History

Erste Schritte

Diese Seite führt dich durch die wichtigsten Abläufe in toolr — vom ersten Besuch bis zum Anlegen und Bewerten eines Tools.

1. Anmelden

Die meisten Aktionen (Tool anlegen, bewerten, Watchlist, Vergleichen) erfordern ein Konto. Klicke unten links auf Anmelden. Je nach Konfiguration der Instanz hast du zwei Möglichkeiten:

  • Lokale Konten: Benutzername + Passwort. Der Zugang wird von einem Admin angelegt (siehe Administration).
  • OIDC (SSO): Anmelden mit dem konfigurierten Identitätsanbieter (z. B. Keycloak).

Welcher Modus aktiv ist, steht im Endpunkt GET /auth/mode. Details findest du im Abschnitt Anmelden & Konto.

2. Tools finden

Öffne den Bereich Tools durchsuchen:

  • Suchen — Volltextsuche über Name & Beschreibung (Tastenkürzel /).
  • Filtern — nach Kategorie, Tags, Features und Mindestbewertung (minRating).
  • Sortieren — nach Aktualität, Top-Bewertung, meistbewertet, Name (auf-/absteigend) oder letztem Update.

Alle Optionen im Detail: Tools finden & durchsuchen.

3. Tool anlegen

Gehe auf Tool hinzufügen und fülle das Formular aus. Details zu jedem Feld findest du im Abschnitt Tool anlegen und in der Feld-Referenz.

4. Bewerten

Auf der Detailseite eines Tools kannst du Nützlichkeit und Bedienbarkeit (jeweils 15) vergeben und optional einen Kommentar hinterlassen. Deine Bewertung fließt sofort in die Statistiken ein. Siehe Bewerten.

5. Weiterführend