feat(docs): mkdocs-style documentation site served at /docs

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

docs/handbook/index.md

@@ -0,0 +1,50 @@
+---
+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.