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
58 lines
1.9 KiB
Markdown
58 lines
1.9 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, Merkliste, 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](/docs/handbook/administration)).
|
||
- **OIDC (SSO):** Anmelden mit dem konfigurierten Identitätsanbieter (z. B.
|
||
Keycloak).
|
||
|
||
Welcher Modus aktiv ist, steht im Endpunkt
|
||
[`GET /auth/mode`](/docs/reference/endpoints/auth#getAuthMode). Details findest
|
||
du im Abschnitt [Anmelden & Konto](/docs/handbook/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](/docs/handbook/tools-finden).
|
||
|
||
## 3. Tool anlegen
|
||
|
||
Gehe auf **Tool hinzufügen** und fülle das Formular aus. Details zu jedem Feld
|
||
findest du im Abschnitt [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.
|
||
Siehe [Bewerten](/docs/handbook/bewerten).
|
||
|
||
## 5. Weiterführend
|
||
|
||
- [Tools vergleichen](/docs/handbook/vergleichen)
|
||
- [Merkliste](/docs/handbook/watchlist)
|
||
- [Analytics](/docs/handbook/analytics)
|
||
- [Pläne & Berechtigungen](/docs/handbook/plaene)
|
||
- [Administration](/docs/handbook/administration)
|