opencode
6c92b6358d
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
55 lines
1.8 KiB
Markdown
55 lines
1.8 KiB
Markdown
---
|
||
title: Erste Schritte
|
||
order: 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](/docs/handbook/administration)).
|
||
- **OIDC (SSO):** Anmelden mit dem konfigurierten Identitätsanbieter.
|
||
|
||
Welcher Modus aktiv ist, steht im [Endpunkt
|
||
`GET /auth/mode`](/docs/reference/endpoints/auth#getauthmode).
|
||
|
||
## 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`](/docs/reference/endpoints/tools#listtools).
|
||
|
||
## 3. Tool anlegen
|
||
|
||
Gehe auf **Tool hinzufügen** und fülle das Formular aus. Details zu jedem Feld
|
||
findest du im [Handbuch "Tool anlegen"](/docs/handbook/tool-anlegen) und in der
|
||
[Feld-Referenz](/docs/reference/schemas/toolinput).
|
||
|
||
## 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.
|
||
|
||
## 5. Weiterführend
|
||
|
||
- [Tools vergleichen](/docs/handbook/vergleichen)
|
||
- [Watchlist](/docs/handbook/watchlist)
|
||
- [Analytics](/docs/handbook/analytics)
|
||
- [Administration & Papierkorb](/docs/handbook/administration)
|