Wie Jamdesk funktioniert
Von Git-Push zu Live-Dokumentation in unter 60 Sekunden. Erfahren Sie, wie Jamdesk Ihre Dokumentationsseite ohne Infrastruktur erstellt, bereitstellt und optimiert.
Jamdesk erstellt Dokumentationsseiten aus MDX-Dateien in Ihrem GitHub-Repository. Sie schreiben Markdown mit React-Komponenten, pushen zu GitHub, und Ihre Website ist in unter 60 Sekunden in einem globalen CDN live. Ihre Inhalte bleiben als reine MDX-Dateien in Ihrem Repository, sodass Sie sie jederzeit in ein anderes Tool übertragen können.
Architekturüberblick
Ihr Repository ist die maßgebliche Quelle. Jamdesk verbindet sich damit, erstellt Ihre Website und stellt sie in einem globalen Edge-Netzwerk bereit. Sie müssen keine Infrastruktur verwalten.
Die Build-Pipeline
Vom Anfang bis zum Ende dauert dies normalerweise 30–60 Sekunden. Builds sind schnell, weil Jamdesk Seiten nicht vorab rendert. Ihre unverarbeiteten Inhalte gelangen an den Edge, und Seiten werden bei Bedarf gerendert, wenn Besucher sie anfordern.
Sie pushen in Ihren verbundenen GitHub-Branch (oder klicken im Dashboard auf Rebuild). Jamdesk klont Ihr Repository und findet Ihr Dokumentationsverzeichnis.
Ihre docs.json-Konfiguration wird anhand des Schemas validiert, und interne Links werden auf fehlerhafte Seiten und ungültige Anker geprüft.
Inhalte werden in das CDN hochgeladen und an mehr als 300 Edge-Standorte verteilt. Da nur geänderte Dateien übertragen werden, sind erneute Bereitstellungen schnell.
In jeder Website enthalten
Jede Website enthält diese Funktionen standardmäßig. Es ist keine Konfiguration erforderlich.
Was einen Build auslöst
Ein Git-Push in Ihren verbundenen Branch, die Schaltfläche Rebuild im Dashboard oder jamdesk deploy über die CLI. Wenn Sie mehrere Commits in kurzer Folge pushen, fasst Jamdesk sie zu einem Build zusammen, damit keine Ressourcen verschwendet werden.
Operative Details zu Statusüberwachung, Rollbacks, Umgebungsvariablen und Branch-Bereitstellungen finden Sie unter Build- und Bereitstellungslebenszyklus.
Sicherheit und Infrastruktur
Sie müssen sich normalerweise nicht darum kümmern. Falls Ihr Sicherheitsteam jedoch nachfragt: Builds laufen in isolierten Containern, und Ihre GitHub-App-Verbindung ist schreibgeschützt.
Leistung
Ob Ihre Dokumentation gefunden wird, hängt teilweise davon ab, wie schnell sie geladen wird. Google verwendet Core Web Vitals als Ranking-Signal, und KI-Crawler wie GPTBot und ClaudeBot geben sich 1–5 Sekunden pro Seite. Wenn Ihre Dokumentation in diesem Zeitfenster nicht geladen wird, wird sie nicht zitiert.
Jede Jamdesk-Website wird vom Edge mit einer Zeit bis zum ersten Byte von unter 50 ms ausgeliefert. Das ist schnell genug für Googles Ranking-Schwellenwerte und damit KI-Crawler die Inhalte abrufen und zitieren können.
| Metrik | Typischer Wert |
|---|---|
| Build-Zeit | 30–60 Sekunden |
| Verteilung der Bereitstellung | < 30 Sekunden |
| Erstes Byte (Edge) | < 50 ms |
| Vollständiger Seitenaufbau | < 500 ms |