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
51 lines
2.0 KiB
Markdown
51 lines
2.0 KiB
Markdown
---
|
||
title: Überblick
|
||
order: 1
|
||
---
|
||
|
||
# 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 |
|
||
| **Bewerten** | Nützlichkeit & Bedienbarkeit (1–5) plus Kommentar vergeben | Angemeldet |
|
||
| **Vergleichen** | Tools nebeneinander gegenüberstellen | Premium |
|
||
| **Watchlist** | Tools als Favoriten speichern | Premium |
|
||
| **Analytics** | Statistiken, Top-Tools, Verteilungen | Alle |
|
||
| **Admin** | Nutzerverwaltung, Audit-Log, Papierkorb | Admin |
|
||
| **Trash** | Soft-gelöschte Tools wiederherstellen oder endgültig löschen | Admin |
|
||
|
||
## Funktionen & Felder im Detail
|
||
|
||
Die **Referenz** ist automatisch aus der OpenAPI-Spezifikation generiert und
|
||
deckt damit garantiert *alle* Endpunkte und Datenfelder der aktuellen Version
|
||
ab:
|
||
|
||
- [Endpunkte](/docs/reference/endpoints/tools) — jede API-Operation mit
|
||
Parametern und Antwort-Schemas.
|
||
- [Datenmodell & Felder](/docs/reference/schemas/tool) — jedes Feld mit Typ,
|
||
Pflichtstatus und Bedeutung.
|
||
|
||
> Die Referenz ist **versionsgebunden**: Wähle oben rechts eine ältere Version,
|
||
> um den API-Stand dieses Releases zu sehen.
|
||
|
||
## Erste Schritte
|
||
|
||
- Neu hier? Starte mit dem [Erste-Schritte-Guide](/docs/handbook/getting-started).
|
||
- Möchtest du ein Tool eintragen? Siehe [Tool anlegen](/docs/handbook/tool-anlegen).
|
||
- Formulare zeigen neben jedem Feld ein **Hilfe-Icon (?)**, das direkt zur
|
||
Erklärung des Felds in der Doku springt.
|
||
|
||
## Wo ist der Quellcode?
|
||
|
||
Über das **Repository-Logo oben rechts** gelangst du direkt zum Quellcode auf
|
||
GitHub.
|