opencode
3bb4598d04
- 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)
53 lines
2.4 KiB
Markdown
53 lines
2.4 KiB
Markdown
|
||
# Willkommen bei toolr
|
||
|
||
toolr ist eine Plattform zum **Entdecken, Bewerten und Vergleichen von
|
||
Entwicklungstools**. Nutzer:innen pflegen einen gemeinsamen Katalog von Tools,
|
||
vergeben Bewertungen (Nützlichkeit & Bedienbarkeit) und nutzen Statistiken, um
|
||
die richtige Wahl zu treffen.
|
||
|
||
## Was kannst du mit toolr tun?
|
||
|
||
| Funktion | Beschreibung | Sichtbarkeit |
|
||
| --- | --- | --- |
|
||
| **Tools durchsuchen** | Katalog filtern, sortieren und durchsuchen | Alle |
|
||
| **Tool anlegen** | Neues Tool mit Beschreibung, Kategorie, Features & Tags eintragen | Angemeldet |
|
||
| **Tool bearbeiten/löschen** | Eigene Tools pflegen (Ersteller:in oder Admin) | Angemeldet |
|
||
| **Bewerten** | Nützlichkeit & Bedienbarkeit (1–5) plus Kommentar vergeben | Angemeldet |
|
||
| **Watchlist** | Tools als Favoriten speichern | Premium |
|
||
| **Vergleichen** | Tools nebeneinander gegenüberstellen | Premium |
|
||
| **Kosten erfassen** | Lizenz- und Kostenmodelle je Tool eintragen | Premium |
|
||
| **Analytics** | Statistiken, Top-Tools, Verteilungen | Alle |
|
||
| **Papierkorb** | Soft-gelöschte Tools wiederherstellen oder endgültig löschen | Premium |
|
||
| **Admin** | Nutzerverwaltung, Audit-Log, Systeminformationen | Admin |
|
||
| **Redundanz** | Automatische Doppelungs-Erkennung | Admin |
|
||
|
||
## Wie diese Doku aufgebaut ist
|
||
|
||
- **User Guide** (diese Seiten): Schritt-für-Schritt-Anleitungen für alle
|
||
Funktionen — von den [Ersten Schritten](/docs/handbook/getting-started) bis
|
||
zur [Administration](/docs/handbook/administration).
|
||
- **API-Referenz**: automatisch aus der OpenAPI-Spezifikation generiert — alle
|
||
[Endpunkte](/docs/reference/endpoints/tools) und
|
||
[Datenfelder](/docs/reference/schemas/toolinput) der aktuellen Version.
|
||
- **Release-Notes**: Was ist in welcher [Version](/docs/releases/v0.8.1) neu.
|
||
|
||
## Der Einstieg
|
||
|
||
Der schnellste Weg:
|
||
|
||
1. **Anmelden** — ohne Konto kannst du nur stöbern
|
||
(siehe [Erste Schritte](/docs/handbook/getting-started#1-anmelden)).
|
||
2. **Tools finden** — Suche, Filter und Sortierung im Bereich
|
||
[Tools durchsuchen](/docs/handbook/tools-finden).
|
||
3. **Tool anlegen** — über „Tool hinzufügen"
|
||
([Anleitung](/docs/handbook/tool-anlegen)).
|
||
4. **Bewerten** — auf der Detailseite eines Tools
|
||
([Anleitung](/docs/handbook/bewerten)).
|
||
|
||
## Kontakt & Quellcode
|
||
|
||
Der Quellcode liegt unter
|
||
[git.kubebase.de/admin/tool-evaluator](https://git.kubebase.de/admin/tool-evaluator) —
|
||
über das Repository-Icon oben rechts erreichst du ihn jederzeit.
|