Files
tool-evaluator/docs/handbook/getting-started.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.8 KiB
Raw Blame History

title, order
title order
Erste Schritte 2

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) erfordern ein Konto. Klicke oben rechts 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.

Welcher Modus aktiv ist, steht im Endpunkt GET /auth/mode.

2. Tools finden

Öffne den Bereich Tools durchsuchen:

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

Die Such-, Filter- und Sortierparameter entsprechen den Query-Parametern von GET /tools.

3. Tool anlegen

Gehe auf Tool hinzufügen und fülle das Formular aus. Details zu jedem Feld findest du im Handbuch "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.

5. Weiterführend