https://valoryx.org/de/ Recent content in Valoryx — Git-Native Dokumentationsplattform on Valoryx Hugo de Wed, 10 Jun 2026 00:00:00 +0000 https://valoryx.org/de/docs/deployment/binary/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/deployment/binary/ Binary-Deployment Die einfachste Deployment-Methode — eine einzelne Binärdatei herunterladen und auf Ihrem Server ausführen. Keine Runtime-Abhängigkeiten, keine Container, kein Orchestrator. Herunterladen Laden Sie die neueste Version für Ihre Plattform herunter: # Empfohlen (erkennt die Plattform automatisch) curl -fsSL https://valoryx.org/install.sh | sh # Oder eine spezifische Plattform-Binärdatei manuell herunterladen curl -sLO https://github.com/Valoryx-org/releases/releases/latest/download/docplatform-linux-amd64 chmod +x docplatform-linux-amd64 sudo mv docplatform-linux-amd64 /usr/local/bin/docplatform # Oder eine spezifische Version herunterladen curl -sLO https://github.com/Valoryx-org/releases/releases/download/v0.5.2/docplatform-linux-amd64 Verfügbare Plattformen: Betriebssystem Architektur Binärdatei Linux amd64 docplatform-linux-amd64 Linux arm64 docplatform-linux-arm64 macOS amd64 (Intel) docplatform-darwin-amd64 macOS arm64 (Apple Silicon) docplatform-darwin-arm64 Windows amd64 docplatform-windows-amd64. https://valoryx.org/de/docs/guides/editor/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/guides/editor/ Der Web-Editor DocPlatform enthält einen Rich-Text-Editor, der auf Tiptap (ProseMirror-basiert) aufbaut und Markdown in Echtzeit rendert, während die volle Markdown-Quelldatei-Kompatibilität erhalten bleibt. Jede Änderung, die Sie vornehmen, erzeugt eine saubere .md-Datei — kein proprietäres Format, keine Herstellerbindung. Editor-Layout ┌─────────────────────────────────────────────────────────────┐ │ Sidebar │ Editor │ │ │ │ │ 📁 Getting │ ┌──────────────────────────────────┐ │ │ Started │ │ Frontmatter (collapsible) │ │ │ 📁 Guides │ │ Title: ___________________ │ │ │ 📁 API │ │ Description: ______________ │ │ │ > auth. https://valoryx.org/de/docs/reference/api/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/reference/api/ REST-API-Referenz DocPlatform stellt eine RESTful-JSON-API unter /api/v1/ bereit. Alle Endpunkte erfordern Authentifizierung, sofern nicht anders angegeben. Basis-URL http://localhost:3000/api/v1 Authentifizierung Die meisten Endpunkte erfordern einen JWT-Access-Token im Authorization-Header: Authorization: Bearer eyJhbGciOiJSUzI1NiIs... Token erhalten Sie über die Login- oder OIDC-Endpunkte. Token-Lebenszyklus Token Lebensdauer Zweck Access-Token 15 Minuten API-Authentifizierung Refresh-Token 30 Tage Neue Access-Token erhalten Auth-Endpunkte Registrieren POST /api/v1/auth/register Erstellt ein neues Benutzerkonto. Der erste Benutzer wird zum Super Admin. Anfrage: { "name": "Jane Smith", "email": "jane@example. https://valoryx.org/de/docs/getting-started/quickstart/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/getting-started/quickstart/ Schnellstart In unter 5 Minuten von Null zu einer laufenden Dokumentationsplattform. Dieser Leitfaden beschreibt den schnellsten Weg — für detaillierte Optionen siehe den Installations-Leitfaden. Schritt 1: Installieren # Empfohlen (erkennt die Plattform automatisch) curl -fsSL https://valoryx.org/install.sh | sh Oder manuell herunterladen: curl -sLO https://github.com/Valoryx-org/releases/releases/latest/download/docplatform-linux-amd64 chmod +x docplatform-linux-amd64 sudo mv docplatform-linux-amd64 /usr/local/bin/docplatform Oder mit Docker: docker run -d --name docplatform -p 3000:3000 -v docplatform-data:/data ghcr.io/valoryx-org/docplatform:latest Bei Verwendung von Docker springen Sie zu Schritt 3 — der Container initialisiert sich automatisch. https://valoryx.org/de/cloud/guides/writing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/cloud/guides/writing/ Schreiben & Bearbeiten Valoryx Cloud bietet Ihnen einen übersichtlichen, ablenkungsfreien Editor, der sich wie Google Docs anfühlt — aber alles als Markdown speichert, für maximale Portabilität. Eine Seite erstellen Öffnen Sie Ihren Workspace über das Dashboard Klicken Sie auf + New Page in der Seitenleiste Geben Sie einen Titel ein und beginnen Sie zu schreiben Seiten werden beim Tippen automatisch gespeichert. Jede Speicherung erstellt eine Version in der Workspace-Historie, sodass Sie jederzeit zurückgehen können. https://valoryx.org/de/docs/configuration/environment/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/configuration/environment/ Umgebungsvariablen DocPlatform liest die Konfiguration aus Umgebungsvariablen. Setzen Sie diese in Ihrer Shell, einer .env-Datei im Arbeitsverzeichnis oder in Ihrem Container-Orchestrator. Server Variable Standard Beschreibung PORT 3000 HTTP-Listening-Port HOST 0.0.0.0 HTTP-Listening-Adresse. Setzen Sie auf 127.0.0.1, um auf localhost zu beschränken. DATA_DIR .docplatform Stammverzeichnis für alle DocPlatform-Daten (Datenbank, Backups, Workspaces, Schlüssel) BASE_DOMAIN — Eigene Domain für veröffentlichte Dokumentation (z. B. docs.yourcompany.com). Wenn gesetzt, verwendet die veröffentlichte Dokumentation diese Domain für kanonische URLs und Sitemap-Einträge. https://valoryx.org/de/docs/configuration/authentication/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/configuration/authentication/ Authentifizierung DocPlatform unterstützt lokale Authentifizierung (E-Mail + Passwort) direkt nach der Installation, mit optionaler Google- und GitHub-OIDC-Anmeldung für Teams, die diese Anbieter nutzen. Lokale Authentifizierung (Standard) Lokale Authentifizierung funktioniert ohne jegliche Konfiguration. Benutzer registrieren sich mit E-Mail und Passwort und melden sich mit denselben Anmeldedaten an. Wie es funktioniert Registrierung — Der Benutzer übermittelt E-Mail + Passwort. Das Passwort wird mit argon2id gehasht (von OWASP 2024 empfohlener Algorithmus). Anmeldung — Der Benutzer übermittelt seine Anmeldedaten. https://valoryx.org/de/docs/reference/cli/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/reference/cli/ CLI-Referenz DocPlatform bietet 5 CLI-Befehle für Serververwaltung, Workspace-Initialisierung, Diagnose und Wartung. Globale Optionen Diese Optionen gelten für alle Befehle: Flag Beschreibung --help, -h Hilfe für jeden Befehl anzeigen --version, -v Versionsinformationen ausgeben docplatform serve HTTP-Server starten. docplatform serve [flags] Flags Flag Standard Beschreibung --port 3000 HTTP-Listening-Port (überschreibt Umgebungsvariable PORT) --host 0.0.0.0 HTTP-Listening-Adresse (überschreibt Umgebungsvariable HOST) --data-dir .docplatform Datenverzeichnispfad (überschreibt Umgebungsvariable DATA_DIR) Verhalten Lädt Umgebungsvariablen aus der .env-Datei (falls vorhanden) Initialisiert die SQLite-Datenbank im WAL-Modus Führt ausstehende Datenbankmigrationen aus Lädt Casbin-Berechtigungsrichtlinien in den Speicher Baut den Bleve-Suchindex auf oder öffnet ihn Startet die Git-Sync-Engine für alle konfigurierten Workspaces Startet den Backup-Scheduler (wenn aktiviert) Stellt den Web-Editor und die API auf dem konfigurierten Port bereit Startsequenz Wenn docplatform serve ausgeführt wird, geschieht Folgendes der Reihe nach: https://valoryx.org/de/docs/deployment/docker/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/deployment/docker/ Docker-Deployment DocPlatform wird als Multi-Architektur-Docker-Image (amd64/arm64) ausgeliefert, basierend auf Alpine Linux. Schnellstart docker run -d \ --name docplatform \ -p 3000:3000 \ -v docplatform-data:/data \ ghcr.io/valoryx-org/docplatform:latest Öffnen Sie http://localhost:3000 und registrieren Sie Ihr Admin-Konto. Erster Start Beim ersten Start führt DocPlatform automatisch folgende Schritte aus: Erstellt die SQLite-Datenbank unter /data/data.db Generiert einen RS256-Signaturschlüssel unter /data/jwt-key.pem Initialisiert den Volltext-Suchindex Beginnt auf Port 3000 zu lauschen Der erste Benutzer, der sich registriert, wird zum Super Admin mit vollem Plattformzugriff. https://valoryx.org/de/cloud/guides/publishing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/cloud/guides/publishing/ Dokumentation veröffentlichen Verwandeln Sie jeden Workspace in eine ansprechende, öffentliche Dokumentationsseite. Ihre Leser erhalten ein schnelles, durchsuchbares und mobilfreundliches Erlebnis — Sie bekommen eine Live-Seite, die sich bei jedem Speichern automatisch aktualisiert. So veröffentlichen Sie Gehen Sie zu Workspace Settings → Published Docs Aktivieren Sie Enable publishing Ihre Dokumentation ist sofort unter app.valoryx.dev/p/your-workspace-slug/ erreichbar Das war’s. Jede Seite in Ihrem Workspace ist nun öffentlich zugänglich. Was Ihre Leser sehen Die veröffentlichte Dokumentation umfasst: https://valoryx.org/de/docs/getting-started/installation/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/getting-started/installation/ Installation DocPlatform wird als einzelne Binärdatei ohne Runtime-Abhängigkeiten ausgeliefert. Wählen Sie die Installationsmethode, die zu Ihrem Workflow passt. Option 1: Vorkompilierte Binärdatei (empfohlen) Laden Sie die neueste Version für Ihre Plattform herunter. Linux / macOS # Empfohlen (erkennt die Plattform automatisch) curl -fsSL https://valoryx.org/install.sh | sh # Oder manuell herunterladen curl -sLO https://github.com/Valoryx-org/releases/releases/latest/download/docplatform-linux-amd64 chmod +x docplatform-linux-amd64 sudo mv docplatform-linux-amd64 /usr/local/bin/docplatform # Installation überprüfen docplatform version Erwartete Ausgabe: docplatform v0.5.2 (commit: abc1234, built: 2026-03-08T10:00:00Z) Windowspowershell# Download and runInvoke-WebRequest https://github. https://valoryx.org/de/docs/guides/markdown/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/guides/markdown/ Markdown & Komponenten DocPlatform verwendet CommonMark-konformes Markdown mit YAML-Frontmatter und 7 benutzerdefinierten Komponenten für reichhaltige, interaktive Dokumentation. Markdown-Grundlagen DocPlatform unterstützt die vollständige CommonMark-Spezifikation sowie gängige Erweiterungen. Überschriften # Heading 1 ## Heading 2 ### Heading 3 #### Heading 4 Überschriften generieren automatisch Anker-IDs für Deep Linking: ## My Section → #my-section. Textformatierung **Bold text** *Italic text* ~~Strikethrough~~ `Inline code` [Link text](https://example.com)  Listen - Unordered item - Another item - Nested item 1. https://valoryx.org/de/docs/reference/troubleshooting/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/reference/troubleshooting/ Fehlerbehebung Dieser Leitfaden behandelt häufige Probleme und deren Lösungen. Für Diagnoseinformationen starten Sie immer mit: docplatform doctor Serverstart Server startet nicht: „address already in use" Ursache: Ein anderer Prozess belegt den konfigurierten Port. Lösung: # Herausfinden, was Port 3000 belegt lsof -i :3000 # macOS/Linux ss -tlnp | grep 3000 # Linux # Option 1: Den anderen Prozess stoppen # Option 2: Einen anderen Port verwenden docplatform serve --port 8080 Server startet nicht: „permission denied" Ursache: Der Prozess hat keine Lese-/Schreibrechte für das Datenverzeichnis. https://valoryx.org/de/docs/guides/git-integration/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/guides/git-integration/ Git-Integration Die bidirektionale Git-Synchronisation von DocPlatform ermöglicht es Ihrem Team, so zu arbeiten, wie es bevorzugt wird. Technische Redakteure nutzen den Web-Editor. Entwickler pushen aus ihrer IDE. Alle sehen denselben Inhalt. Wie es funktioniert ┌─────────────┐ │ Web Editor │ │ (browser) │ └──────┬───────┘ │ save ▼ ┌─────────────┐ ┌──────────────┐ │ Content │ commit │ Local Git │ push ┌──────────────┐ │ Ledger │ ───────► │ Repository │ ───────► │ Remote Repo │ │ │ │ (. https://valoryx.org/de/docs/getting-started/first-workspace/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/getting-started/first-workspace/ Ihr erster Workspace Ein Workspace ist der übergeordnete Container für ein Dokumentationsprojekt. Jeder Workspace wird einem Verzeichnis mit Markdown-Dateien zugeordnet und synchronisiert sich optional mit einem Git-Repository. Workspace-Konzepte Konzept Beschreibung Workspace Ein Dokumentationsprojekt mit Seiten, Mitgliedern und Einstellungen Seite Eine Markdown-Datei mit YAML-Frontmatter (Titel, Beschreibung, Tags, Zugriff) Slug Die URL-sichere Kennung für Ihren Workspace (z. B. my-docs → /p/my-docs/) Mitglied Ein Benutzer mit einer Rolle im Workspace (Viewer bis Admin) Workspace erstellen Über CLI docplatform init \ --workspace-name "Engineering Docs" \ --slug eng-docs Über Web-Oberfläche Melden Sie sich als Super Admin oder Admin an Öffnen Sie den Workspace-Umschalter (Dropdown oben links) Klicken Sie auf Create Workspace Geben Sie einen Namen und Slug ein Konfigurieren Sie optional ein Git-Remote Git-Repository verbinden Bidirektionale Synchronisation hält Ihre Workspace-Dateien und ein Remote-Git-Repository synchron. https://valoryx.org/de/docs/deployment/production/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/deployment/production/ Produktions-Checkliste Verwenden Sie diese Checkliste, bevor Sie DocPlatform in einer Produktionsumgebung deployen. Jeder Punkt verlinkt zum relevanten Dokumentationsabschnitt. Erforderlich Diese Punkte sind für ein sicheres, zuverlässiges Produktions-Deployment notwendig. Server Persistenter Speicher konfiguriert — Mounten Sie ein Volume oder verwenden Sie einen stabilen Dateisystempfad für DATA_DIR. Der Verlust dieses Verzeichnisses bedeutet Verlust aller Daten. Prozessmanager vorhanden — Verwenden Sie systemd, Docker mit restart: unless-stopped oder einen Container-Orchestrator, um sicherzustellen, dass der Server nach Abstürzen oder Neustarts wieder hochfährt. https://valoryx.org/de/docs/configuration/permissions/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/configuration/permissions/ Rollen & Berechtigungen DocPlatform verwendet rollenbasierte Zugriffskontrolle (RBAC), gestützt durch benutzerdefiniertes RBAC, eine In-Process-Autorisierungs-Engine. Berechtigungen werden in unter 0,1ms pro Prüfung ausgewertet, ohne externen Dienst. Rollenhierarchie DocPlatform definiert 5 öffentlich sichtbare Rollen in einer strikten Hierarchie. Höhere Rollen erben alle Berechtigungen niedrigerer Rollen. Super Admin ← Org-Eigentümer / Kontoersteller (höchste öffentliche Rolle) │ Admin ← Workspace-Einstellungen, Mitglieder, Git, Theme verwalten │ Editor ← Seiten erstellen und bearbeiten (pro Workspace konfigurierbar) │ Commenter ← Seiten ansehen, Kommentare hinterlassen │ Viewer ← Nur Seiten ansehen Platform Owner ist eine interne Rolle für selbst-gehostete Betreiber zur Plattformwartung (Datenbankmigrationen, Lizenzverwaltung, Systemkonfiguration). https://valoryx.org/de/cloud/guides/collaboration/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/cloud/guides/collaboration/ Zusammenarbeit im Team Valoryx Cloud ist für Teams gebaut. Laden Sie Ihre Kollegen ein, kontrollieren Sie, wer was bearbeiten darf, und sehen Sie Änderungen in Echtzeit. Teammitglieder einladen Gehen Sie zu Workspace Settings → Members Geben Sie die E-Mail-Adresse ein Wählen Sie eine Rolle (siehe unten) Klicken Sie auf Send Invitation Die eingeladene Person erhält eine E-Mail mit einem Link zum Beitritt. Falls sie noch kein Valoryx-Konto hat, wird sie zur Registrierung aufgefordert. https://valoryx.org/de/cloud/guides/git-sync/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/cloud/guides/git-sync/ GitHub Sync Valoryx Cloud kann Ihre Dokumentation mit einem GitHub-Repository synchronisieren. So erhalten Sie das Beste aus beiden Welten: einen ansprechenden Web-Editor UND die volle Leistungsfähigkeit von Git. Warum GitHub verbinden? Backup — Ihre Dokumentation ist immer sicher auf GitHub, selbst wenn Sie Ihr Konto kündigen IDE-Bearbeitung — Entwickler in Ihrem Team können Dokumentation in VS Code, Vim oder jedem anderen Editor bearbeiten Pull Requests — nutzen Sie den GitHub-PR-Workflow für Dokumentations-Reviews vor der Veröffentlichung Versionshistorie — vollständiges Git Blame, Diff und Rollback für jede Änderung CI/CD-Integration — lösen Sie Builds oder Tests aus, wenn sich die Dokumentation ändert So funktioniert es Sie bearbeiten im Browser → Auto-Save → Auto-Commit → Push zu GitHub ↕ Teammitglied pusht aus IDE → GitHub → Webhook → Pull zu Valoryx Änderungen fließen automatisch in beide Richtungen. https://valoryx.org/de/docs/guides/collaboration/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/guides/collaboration/ Teams & Zusammenarbeit DocPlatform ist für Team-Dokumentation konzipiert. Laden Sie Mitglieder ein, weisen Sie granulare Rollen zu und verfolgen Sie jede Änderung mit einem vollständigen Audit-Trail. Workspace-Mitgliedschaft Jeder Benutzer gehört einem oder mehreren Workspaces mit einer bestimmten Rolle an. Rollen bestimmen, welche Aktionen ein Benutzer ausführen kann. Mitglieder einladen Über Web-Oberfläche: Öffnen Sie Workspace Settings → Members Klicken Sie auf Invite Member Geben Sie die E-Mail-Adresse der Person ein Wählen Sie eine Rolle Klicken Sie auf Send Wenn SMTP konfiguriert ist, wird eine Einladungs-E-Mail mit einem eindeutigen Link gesendet. https://valoryx.org/de/docs/configuration/workspace-config/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/configuration/workspace-config/ Workspace-Einstellungen Jeder Workspace hat seine eigene Konfigurationsdatei unter .docplatform/workspaces/{workspace-id}/.docplatform/config.yaml. Bearbeiten Sie diese Datei direkt oder nutzen Sie die Web-Oberfläche (Settings → Workspace). Vollständige Konfigurationsreferenz # Workspace-Identität workspace_id: 01KJJ10NTF31Z1QJTG4ZRQZ2Z2 # Automatisch generierte ULID name: "Engineering Docs" # Anzeigename slug: eng-docs # URL-Slug für veröffentlichte Dokumentation description: "Internal engineering documentation" # Git-Synchronisation git_remote: git@github.com:your-org/eng-docs.git git_branch: main git_auto_commit: true # Editor-Speicherungen automatisch in Git committen sync_interval: 300 # Polling-Intervall in Sekunden (0 = deaktiviert) # Theme theme: mode: auto # light, dark, auto (folgt Systemeinstellung) accent: blue # Akzentfarbe für veröffentlichte Seite # Veröffentlichungsstandards publishing: default_published: false # Neue Seiten standardmäßig veröffentlicht? https://valoryx.org/de/docs/guides/publishing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/guides/publishing/ Dokumentation veröffentlichen DocPlatform kann Ihre Dokumentation als öffentliche Website bereitstellen — komplett mit Navigations-Seitenleiste, Syntax-Highlighting und SEO-Metadaten. Kein separater Static-Site-Generator erforderlich. Wie die Veröffentlichung funktioniert Veröffentlichte Dokumentation wird unter /p/{workspace-slug}/{page-path} bereitgestellt: http://localhost:3000/p/my-docs/ → docs/index.md http://localhost:3000/p/my-docs/quickstart → docs/quickstart.md http://localhost:3000/p/my-docs/api/auth → docs/api/auth.md Seiten werden bei Anfrage von Markdown zu HTML gerendert, unter Verwendung von goldmark (CommonMark-konform) mit Chroma-Syntax-Highlighting für Codeblöcke. Seitenstatus-Lebenszyklus Seiten haben ein status-Feld, das ihre Sichtbarkeit steuert: Status Im Editor In veröffentlichter Seite In der Suche draft (Standard) Sichtbar Verborgen Nur für Mitglieder sichtbar published Sichtbar Sichtbar Sichtbar gemäß Zugriffsregeln archived Sichtbar (abgedimmt) Verborgen Verborgen Setzen Sie den Status im Frontmatter: https://valoryx.org/de/cloud/guides/mcp/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/cloud/guides/mcp/ KI & MCP-Integration Valoryx Cloud enthält einen integrierten MCP-Server (Model Context Protocol), der KI-Assistenten die direkte Interaktion mit Ihrer Dokumentation ermöglicht. Was ist MCP? MCP ist ein Standardprotokoll, das KI-Tools die Verbindung mit externen Diensten ermöglicht. Stellen Sie es sich so vor, als würden Sie Claude oder Cursor die Möglichkeit geben, Ihre Dokumentation zu „sehen" und Änderungen vorzunehmen — mit Ihrer Genehmigung. Was KI mit Ihrer Dokumentation tun kann Lesen — Seiten lesen, um Fragen zu Ihrer Dokumentation zu beantworten Suchen — seitenübergreifend nach relevanten Inhalten suchen Erstellen — neue Seiten nach Ihren Anweisungen anlegen Bearbeiten — bestehende Seiten überarbeiten, verbessern oder übersetzen Analysieren — Ihre Dokumentation auf Lücken, Widersprüche oder veraltete Inhalte prüfen Einrichtung Status: Der gehostete MCP-Endpunkt für Valoryx Cloud ist noch nicht aktiviert — Remote-KI-Tools können sich noch nicht mit app. https://valoryx.org/de/cloud/guides/account/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/cloud/guides/account/ Ihr Konto Registrierung Besuchen Sie app.valoryx.dev und erstellen Sie ein Konto mit Ihrer E-Mail-Adresse und einem Passwort. Sie müssen die Nutzungsbedingungen und die Datenschutzerklärung akzeptieren. Sie können sich auch mit Google oder GitHub anmelden, sofern diese Optionen verfügbar sind. Profileinstellungen Klicken Sie auf Ihren Avatar in der oberen linken Ecke und dann auf Profile, um: Ihren Anzeigenamen zu ändern Ihre E-Mail-Adresse zu aktualisieren Ihr Passwort zu ändern Einen Passkey (WebAuthn) für passwortlose Anmeldung einzurichten Abrechnung Gehen Sie zu Workspace Settings → Billing, um: https://valoryx.org/de/docs/guides/search/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/guides/search/ Suche DocPlatform enthält eine eingebettete Volltextsuche (Bleve), die alle Inhalte automatisch indiziert. Kein externer Dienst zu konfigurieren — die Suche funktioniert sofort nach der Installation. Suche verwenden Cmd+K-Dialog Drücken Sie Cmd+K (macOS) oder Ctrl+K (Windows/Linux) an beliebiger Stelle im Web-Editor, um den Suchdialog zu öffnen. ┌──────────────────────────────────────────┐ │ 🔍 Search documentation... │ ├──────────────────────────────────────────┤ │ │ │ 📄 Getting Started │ │ Install and configure DocPlatform... │ │ │ │ 📄 API Authentication │ │ JWT tokens, OAuth2, and session. https://valoryx.org/de/docs/guides/ai-features/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/guides/ai-features/ AI Features DocPlatform includes built-in AI capabilities powered by Claude (Anthropic) or OpenAI. These features help you write, improve, and explore your documentation faster. Setup Enable AI features by setting your provider and API key: # .env AI_PROVIDER=anthropic # or "openai" AI_API_KEY=sk-ant-... # your API key AI_MODEL= # optional — uses provider default if empty Restart the server. AI features appear in the editor toolbar and are accessible via the API. https://valoryx.org/de/docs/guides/analytics/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/guides/analytics/ Analytics DocPlatform includes built-in analytics for tracking how your documentation is used. No third-party tracking scripts or external services required. How it works Analytics data is collected in a separate analytics.db SQLite database (not in the main database). This separation ensures analytics never impact content performance. What is tracked Data point Description Page path Which page was viewed Referrer Where the visitor came from Timestamp When the page was viewed Search queries What users searched for What is NOT tracked IP addresses (never stored) User agents are not stored Cookies or cross-session identifiers (without consent) Personally identifiable information GDPR compliance Analytics requires explicit cookie consent from visitors. https://valoryx.org/de/docs/guides/billing/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/guides/billing/ Billing & Plans DocPlatform uses Stripe for subscription billing. Three plan tiers are available, each with different limits and features. Plans Feature Community (Free) Free Team ($29/mo) Business ($79/mo) Editors Unlimited 3 15 50 Workspaces Unlimited 1 3 10 Viewers / Commenters Unlimited Unlimited Unlimited Unlimited Pages Unlimited 50 150 500 Published docs Unlimited Unlimited Unlimited Unlimited Analytics — — Included Included Custom domains — — Included Included Advanced AI — — Included Included Priority support — — — Included Annual pricing Annual subscriptions include 2 months free: https://valoryx.org/de/docs/guides/mcp/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/docs/guides/mcp/ MCP Server — AI Integration Guide DocPlatform includes a built-in Model Context Protocol (MCP) server that lets AI assistants read, write, search, and manage your documentation directly. Instead of copy-pasting content into chat windows, your AI tools work with your docs natively. Prerequisites DocPlatform running (binary, Docker, or Fly.io) An API key (create one in Workspace Settings → API Keys) Quick start 1. Create an API key In your DocPlatform instance, go to Workspace Settings → API Keys → Create Key. https://valoryx.org/de/changelog/v0.11.1/ Wed, 10 Jun 2026 00:00:00 +0000 https://valoryx.org/de/changelog/v0.11.1/ Dieser Eintrag fasst alles zusammen, was zwischen v0.6.4 und v0.11.1 ausgeliefert wurde. Die vollständigen Details pro Release liefert das Changelog der Produktdokumentation. MCP-Server: 26 Tools Der integrierte MCP-Server ist von 13 auf 26 Tools gewachsen — Content-CRUD, Suche, RAG-Kontextpakete, Qualitätsprüfung, Versionierung, Export, KI-Schreibassistent, Kommentare, Aktivität, Workspace-Veröffentlichung und Konfliktauflösung für Git-Sync. Zwei Transporte: stdio für lokale KI-Tools, Streamable HTTP für Cloud-Zugriff. Siehe die MCP-Seite. Veröffentlichung als Code Publish-Overlay — .docplatform/publish.yaml gibt Ihnen git-überprüfbare Kontrolle darüber, welche Seiten genau öffentlich werden; es überschreibt das Frontmatter pro Pfad. https://valoryx.org/de/blog/ai-native-documentation/ Mon, 13 Apr 2026 00:00:00 +0000 https://valoryx.org/de/blog/ai-native-documentation/ Dokumentation hat ein Pflegeproblem. Sie schreiben eine Anleitung, veröffentlichen sie, und innerhalb von drei Monaten ist sie veraltet. Die API hat sich geändert. Das Konfigurationsformat wurde refaktoriert. Eine Abhängigkeit wurde ersetzt. Die Screenshots zeigen eine Oberfläche, die nicht mehr existiert. Die Lösung ist nicht „bessere Dokumentation schreiben" oder „eine Dokumentationskultur aufbauen." Teams versuchen das seit Jahrzehnten. Die Lösung ist, Dokumentation bewusst mit dem Code zu verknüpfen, den sie beschreibt — sodass die Dokumentation es mitbekommt, wenn sich der Code ändert. https://valoryx.org/de/blog/documentation-platform-cost/ Thu, 09 Apr 2026 00:00:00 +0000 https://valoryx.org/de/blog/documentation-platform-cost/ Pro-Benutzer-Preise klingen auf den ersten Blick vernünftig. Fünf Benutzer für 8 $/Monat? Das sind 40 $. Ihr Team kann sich 40 $ leisten. Aber Dokumentation ist eines dieser Tools, bei dem die Anzahl der Personen, die Zugang haben sollten, ständig wächst. Ingenieure müssen schreiben. Produktmanager müssen reviewen. Support-Mitarbeiter müssen nachschlagen. Neue Mitarbeiter müssen lesen und kommentieren. Plötzlich sind Sie nicht bei 5 Plätzen — Sie sind bei 50, und diese „erschwinglichen" 8 $/Platz sind 400 $/Monat für ein Tool, das Textdateien speichert. https://valoryx.org/de/blog/docs-for-open-source/ Mon, 06 Apr 2026 00:00:00 +0000 https://valoryx.org/de/blog/docs-for-open-source/ Open-Source-Projekte leben oder sterben mit ihrer Dokumentation. Eine Bibliothek mit guter Dokumentation wird adoptiert. Eine Bibliothek mit einem dürren README und einer „Lies den Code"-Einstellung wird von jemandem geforkt, der bessere Dokumentation schreibt — oder einfach ignoriert. Aber die meisten Dokumentationstools sind für Unternehmen gebaut, nicht für OSS-Maintainer. Sie berechnen pro Benutzer, pro Seite oder pro Workspace. Für ein Projekt, das von Freiwilligen ohne Budget gepflegt wird, ist das ein Ausschlusskriterium. https://valoryx.org/de/blog/documentation-search-works/ Thu, 02 Apr 2026 00:00:00 +0000 https://valoryx.org/de/blog/documentation-search-works/ Sie tippen eine Abfrage in die Suchleiste Ihrer Dokumentation. Ergebnisse erscheinen. Aber was passiert zwischen dem Tastendruck und den Ergebnissen? Bei den meisten Dokumentationsplattformen lautet die Antwort entweder „nicht viel" (einfacher Keyword-Abgleich, der offensichtliche Ergebnisse übersieht) oder „eine Menge Infrastruktur" (ein Elasticsearch-Cluster, den Ihr Ops-Team warten muss). Es gibt einen Mittelweg, den die meisten Teams nicht kennen: eingebettete Volltextsuche. DocPlatform verwendet Bleve, eine in Go geschriebene Suchbibliothek, die direkt in das Binary kompiliert wird. https://valoryx.org/de/blog/single-binary-architecture/ Mon, 30 Mar 2026 00:00:00 +0000 https://valoryx.org/de/blog/single-binary-architecture/ Die meisten Dokumentationsplattformen werden als Stack ausgeliefert. Sie bekommen eine Node.js-Anwendung, eine PostgreSQL-Datenbank, einen Redis-Cache, einen Elasticsearch-Cluster für die Suche und einen Nginx-Reverse-Proxy, der alles zusammenhält. Fünf Dienste, fünf Dinge, die kaputtgehen können, fünf Dinge, die überwacht, gepatcht und aktualisiert werden müssen. DocPlatform wird als eine Datei ausgeliefert. Herunterladen, ausführen, fertig. Das ist kein Marketing-Trick. Es ist eine Architekturentscheidung, die wir am ersten Tag getroffen haben, und jede Designentscheidung seitdem folgt daraus. https://valoryx.org/de/blog/keep-docs-up-to-date/ Thu, 26 Mar 2026 00:00:00 +0000 https://valoryx.org/de/blog/keep-docs-up-to-date/ Jedes Engineering-Team hat dasselbe Dokumentationsproblem. Jemand schreibt gründliche Dokumentation während eines Launches. Sechs Monate später hat sich die API geändert, das Konfigurationsformat ist anders, und drei Seiten verweisen auf ein Feature, das umbenannt wurde. Niemand hat die Dokumentation aktualisiert, weil das Aktualisieren von Dokumentation eine separate Aufgabe vom Code-Schreiben ist, und separate Aufgaben werden vergessen. Der übliche Ratschlag — „Machen Sie Dokumentation zum Teil Ihrer Kultur" — funktioniert nicht. Kultur überlebt keinen Termindruck. https://valoryx.org/de/blog/docs-regulated-industries/ Mon, 23 Mar 2026 00:00:00 +0000 https://valoryx.org/de/blog/docs-regulated-industries/ Wenn Sie im Gesundheitswesen, in der Verteidigung, im Finanzwesen oder in einer anderen Branche arbeiten, in der Datenresidenz wichtig ist, haben Sie das Gespräch bereits geführt: „Können wir dieses SaaS-Tool verwenden, oder muss es durch eine sechsmonatige Sicherheitsüberprüfung?" Bei den meisten Cloud-Dokumentationsplattformen ist die Antwort die Überprüfung — und sie endet oft mit „Nein." Das Problem ist nicht, dass Cloud-Tools unsicher sind. Die meisten von ihnen sind in Sachen Sicherheit kompetent. https://valoryx.org/de/blog/bidirectional-git-sync/ Thu, 19 Mar 2026 00:00:00 +0000 https://valoryx.org/de/blog/bidirectional-git-sync/ Jede Dokumentationsplattform mit einer Git-Integrationsseite macht dasselbe Versprechen: Ihre Dokumentation lebt in Git, Ihr Team bearbeitet im Browser, und alles bleibt synchron. In der Praxis sind die meisten dieser Integrationen Einweg-Spiegel, die auseinanderfallen, sobald zwei Personen aus verschiedenen Richtungen bearbeiten. Wir haben in einem früheren Beitrag geschrieben, warum das passiert. Dieser geht tiefer in die Lösung: wie Valoryx bidirektionalen Sync mit dem Content-Ledger-Muster implementiert und warum dieser Ansatz die Szenarien bewältigt, an denen andere Tools scheitern. https://valoryx.org/de/blog/mcp-documentation-guide/ Mon, 16 Mar 2026 00:00:00 +0000 https://valoryx.org/de/blog/mcp-documentation-guide/ Model Context Protocol (MCP) ist ein offener Standard, der KI-Assistenten die Interaktion mit externen Tools und Datenquellen über eine strukturierte Schnittstelle ermöglicht. Anstatt Text in ein Chat-Fenster zu kopieren und darauf zu hoffen, dass das Modell den Kontext versteht, gibt MCP dem Assistenten direkten, typisierten Zugriff auf Ihre Systeme — Dateien lesen, Suchen ausführen, Inhalte erstellen, alles über wohldefinierte Tool-Aufrufe. Für Dokumentationsteams verändert dies den Workflow grundlegend. Ihr KI-Assistent ist nicht mehr ein Textgenerator, der mit veraltetem Kontext arbeitet, sondern wird zu einem Teilnehmer, der Ihre tatsächliche Dokumentation liest, Ihre Wissensbasis durchsucht und Änderungen vornimmt, die Sie prüfen können, bevor sie live gehen. https://valoryx.org/de/blog/internal-docs-developers-use/ Thu, 12 Mar 2026 00:00:00 +0000 https://valoryx.org/de/blog/internal-docs-developers-use/ Jede Engineering-Organisation hat interne Dokumentation. Und in den meisten davon ist diese Dokumentation unvollständig, veraltet oder wird ignoriert. Laut der 2024 Stack Overflow Developer Survey betrachtet eine Mehrheit der Entwickler fehlende oder schlechte Dokumentation als erhebliche Produktivitätshürde. Das ist kein Disziplinproblem. Es ist ein Werkzeugproblem. Interne Dokumentation scheitert aus spezifischen, behebbaren Gründen. Die Werkzeuge machen das Schreiben schmerzhaft. Der Inhalt veraltet, weil niemand einen Workflow hat, um ihn aktuell zu halten. https://valoryx.org/de/blog/docs-should-be-in-git/ Mon, 09 Mar 2026 00:00:00 +0000 https://valoryx.org/de/blog/docs-should-be-in-git/ Hier ist eine Bestandsaufnahme dessen, was ein typisches Engineering-Team in Git aufbewahrt: Anwendungsquellcode Infrastrukturdefinitionen (Terraform, Pulumi, CloudFormation) CI/CD-Pipeline-Konfigurationen Datenbankmigrationen API-Spezifikationen (OpenAPI, Protobuf) Deployment-Manifeste (Kubernetes, Docker Compose) Umgebungskonfigurations-Templates Und hier ist, was normalerweise außerhalb von Git lebt: Dokumentation Das ist merkwürdig. Dokumentation beschreibt das System. Sie ändert sich, wenn sich das System ändert. Sie braucht Review, Versionierung, Zuordnung und die Möglichkeit zum Rollback. Jedes andere Artefakt, das diese Eigenschaften teilt, lebt in Git. https://valoryx.org/de/changelog/v0.5.2/ Sat, 07 Mar 2026 00:00:00 +0000 https://valoryx.org/de/changelog/v0.5.2/ Abrechnungsintegration Stripe-basierte Abrechnung ist jetzt integriert. Konfigurieren Sie Tarife, verwalten Sie Abonnements und führen Sie Upgrades direkt über das Admin-Dashboard durch. Stripe-Webhook-Integration mit 5 Ereignistypen Abonnement-Lebenszyklusverwaltung (Erstellen, Upgrade, Kündigung) Nutzungsbasierte Erfassung für API-Aufrufe und Speicher Rechnungserstellung und Zahlungshistorie Konfigurierbare Tariflimits pro Workspace Analytics-Dashboard Verfolgen Sie die Leistung Ihrer Dokumentation mit dem neuen Analytics-Dashboard. Seitenaufruf-Tracking mit täglicher, wöchentlicher und monatlicher Aggregation Meistbesuchte Seiten und Trend-Inhalte Suchanfragen-Analyse mit Tracking von Null-Ergebnissen Nutzer-Engagement-Metriken (Verweildauer, Scrolltiefe) Analytics-Daten als CSV exportieren KI-Schreibassistent KI-gestützte Schreibwerkzeuge direkt im Editor integriert. https://valoryx.org/de/blog/documentation-as-code/ Thu, 05 Mar 2026 00:00:00 +0000 https://valoryx.org/de/blog/documentation-as-code/ „Documentation as Code" wird häufig verwendet. Im einfachsten Sinne bedeutet es, Dokumentation genauso zu behandeln wie Quellcode: in der Versionskontrolle gespeichert, in Klartext geschrieben, über Pull Requests überprüft und durch CI/CD gebaut. Aber zwischen der Idee und der guten Umsetzung klafft eine Lücke. Dieser Leitfaden erklärt, was Docs-as-Code ist, welche Ansätze existieren und wo jeder an seine Grenzen stößt. Warum Docs-as-Code wichtig ist Softwareteams haben bereits Workflows für das Änderungsmanagement. Code durchläuft Versionskontrolle, Review, Tests und Deployment. https://valoryx.org/de/blog/self-host-docs-5-minutes/ Mon, 02 Mar 2026 00:00:00 +0000 https://valoryx.org/de/blog/self-host-docs-5-minutes/ Die meisten selbstgehosteten Dokumentationstools erfordern eine Datenbank, einen Reverse-Proxy und einen halben Nachmittag YAML-Bearbeitung, bevor Sie einen Willkommensbildschirm sehen. DocPlatform ist ein einzelnes Go-Binary ohne externe Abhängigkeiten. Diese Anleitung bringt Sie in etwa fünf Minuten von Null zur veröffentlichten Dokumentation. Voraussetzungen Sie benötigen einen Linux-, macOS- oder Windows-Rechner. Das war’s. Kein Docker, kein PostgreSQL, keine Node.js-Laufzeitumgebung. DocPlatform kompiliert zu einem einzelnen statischen Binary — die Go-Laufzeitumgebung ist eingebettet. Falls Sie sich für die Implementierungssprache interessieren: Go erzeugt eigenständige ausführbare Dateien, die ohne Installation auf dem Host laufen. https://valoryx.org/de/blog/notion-alternative-self-hosted/ Sun, 01 Mar 2026 00:00:00 +0000 https://valoryx.org/de/blog/notion-alternative-self-hosted/ Notion ist überall. Design-Teams, Produkt-Teams, Marketing-Teams — und zunehmend auch Entwicklerteams nutzen es für Dokumentation. Es funktioniert, bis zu einem gewissen Punkt. Dann stößt man an die Grenzen, und die Grenzen sind scharf. Was Notion richtig macht Der Editor ist schnell und flexibel. Datenbankansichten sind nützlich für Roadmaps. Für nicht-technische Dokumentation ist Notion schwer zu übertreffen. Wo Notion für technische Teams scheitert Keine git-Integration. Die Codebasis lebt in git. Aber die Dokumentation lebt in Notions proprietärer Datenbank, von allem anderen abgekoppelt. https://valoryx.org/de/blog/self-hosted-docs-guide/ Fri, 27 Feb 2026 00:00:00 +0000 https://valoryx.org/de/blog/self-hosted-docs-guide/ Self-hosted Dokumentation erlebt gerade einen Aufschwung. Nachdem SaaS-Plattformen jahrelang die Preise erhöht, die Nutzungsbedingungen geändert und ohne Vorwarnung abgeschaltet haben, entscheiden sich immer mehr Teams dafür, ihre eigene Dokumentationsinfrastruktur zu betreiben. Die Gründe liegen auf der Hand: Dateneigentum, Kostenkontrolle, Compliance und die Gewissheit, dass die eigene Wissensdatenbank nicht verschwindet, wenn ein Startup das Geld ausgeht. Die Landschaft der self-hosted Dokumentationstools ist jedoch überfüllt und unübersichtlich. Es gibt Wiki-Plattformen, Static-Site-Generatoren, Wissensdatenbanken und Hybridlösungen — jede mit unterschiedlichen Kompromissen. https://valoryx.org/de/blog/gitbook-vs-valoryx/ Wed, 25 Feb 2026 00:00:00 +0000 https://valoryx.org/de/blog/gitbook-vs-valoryx/ GitBook ist eine der beliebtesten Dokumentationsplattformen für Entwicklerteams. Es bietet einen ausgefeilten Editor, solide Kollaborationsfunktionen und ansprechend aussehende veröffentlichte Docs. Wir haben Valoryx entwickelt, um Probleme zu lösen, die GitBook nicht adressiert — in erster Linie in Bezug auf git-Eigentümerschaft, Self-Hosting und Preistransparenz. Hier ist, wo jedes Tool glänzt und wo jedes an seine Grenzen stößt. Editor-Erfahrung GitBook hat einen hervorragenden Web-Editor. Block-basiert, sauber, responsiv. Unterstützt Markdown-Shortcuts, Code-Blöcke, Tabellen, Einbettungen. Kollaborationsfunktionen sind gut durchdacht. https://valoryx.org/de/blog/why-git-sync-breaks/ Sun, 22 Feb 2026 00:00:00 +0000 https://valoryx.org/de/blog/why-git-sync-breaks/ Wenn man technische Dokumentation pflegt, wurde man wahrscheinlich schon einmal von “Vollständiger git-Integration” enttäuscht. Man verbindet das Repository, pusht einen Commit aus der IDE — und alles bricht zusammen. Merge-Konflikte. Verlorene Bearbeitungen. Seiten, die stillschweigend zurückgesetzt werden. Das ist kein Bug. Es ist ein grundlegender Designfehler. Die drei Arten, wie git-Sync scheitert 1. Einseitiger Spiegel, kein echter Sync Die meisten Plattformen behandeln git als Backup-Ziel. Bearbeitungen fließen von der Web-UI in git, aber Änderungen, die aus einer IDE gepusht werden, werden ignoriert oder verursachen Konflikte. https://valoryx.org/de/vs/gitbook/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/de/vs/gitbook/