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.8 KiB
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 1–5) vergeben und optional einen Kommentar hinterlassen. Deine Bewertung fließt sofort in die Statistiken ein.