Dein erstes Hilfe-Center starten

Eine Dokumentations-Website ist ein gehostetes Hilfe-Center, das aus den Artikeln in deinem Arbeitsbereich erstellt wird. Es bietet eine Suchfunktion, einen <b>KI-Assistenten</b> und Feedback-Optionen für Leser. Dieser Artikel führt dich von deinen ersten Artikeln bis zur Live-Website unter deiner eigenen Adresse. Jeder Schritt verlinkt auf den entsprechenden Artikel mit weiteren Details.

Bevor du beginnst#

• <b>Deine Rolle:</b> Arbeitsbereich-Inhaber und Administratoren erstellen und konfigurieren Dokumentations-Websites. Content Creators können Seiten hinzufügen und Editoren können diese veröffentlichen. Siehe wer was tun kann.
• <b>Dein Plan:</b> Dokumentations-Websites sind in jedem Plan verfügbar, auch im Free-Plan. Free und Starter beinhalten 1 Website; Pro beinhaltet 2–5, je nach Anzahl der Plätze. Siehe Pläne und Limits für Dokumentations-Websites.
• <b>Free-Plan:</b> Für die Veröffentlichung ist eine verifizierte E-Mail-Adresse erforderlich.

Schritt für Schritt aufbauen#

1. Deine ersten Artikel schreiben#

   Eine Website zeigt Artikel an, also beginne mit ein paar davon. Klicke auf Erstellen, öffne den Tab Artikel und wähle eine Art aus: Anleitungsartikel, Fehlerbehebung, Standardarbeitsanweisung, Blogbeitrag oder Produkt-Update. Füge eine Aufnahme hinzu – über die Desktop-App, die Chrome-Erweiterung, einen Upload, deine Bibliothek oder Mit KI aufnehmen – und klicke auf Artikel generieren. Ein Artikel kostet in der Regel 5–15 Credits. Siehe Verwandle eine Aufnahme in einen Artikel.

   Hast du bereits ein Hilfe-Center an anderer Stelle? Du kannst es stattdessen importieren, wenn du die Website erstellst (nächster Schritt).

2. Die Dokumentations-Website erstellen#

   Klicke in der Seitenleiste auf <b>Dokumentations-Websites</b> und dann auf <b>Neue Dokumentationsseite</b>. Der Assistent führt dich durch drei Schritte:

   1. <b>Website benennen:</b> Gib einen <b>Website-Name</b> ein und prüfe die kostenlose <b>Adresse</b>, die auf .clevera.help endet. Wähle die <b>Sprache</b> der Website aus.
   2. <b>Was soll darauf?:</b> Wähle <b>Aus einer Sammlung</b> (jeder Ordner wird zu einem Abschnitt), <b>Inhalt auswählen</b>, <b>Leer starten</b> oder <b>Von einem anderen Tool importieren</b>.
   3. <b>Gestalte sie nach deinen Wünschen:</b> Füge ein <b>Logo</b>, eine <b>Markenfarbe</b>, eine <b>Schriftart</b> und das <b>Standard-Erscheinungsbild</b> hinzu.

   Klicke auf <b>Website erstellen</b>. Wenn du mit Inhalten startest, wird die Website sofort unter ihrer kostenlosen Adresse veröffentlicht und öffnet sich in der <b>Übersicht</b> mit einer <b>Loslegen</b>-Checkliste. Siehe Eine Dokumentations-Website erstellen.

3. Seiten hinzufügen und organisieren#

   Öffne <b>Seiten</b> in der Seitenleiste der Website, um Abschnitte hinzuzufügen, Artikel aus deiner Bibliothek einzubinden, neue Seiten zu schreiben und deren Reihenfolge festzulegen. Die Checkliste erfordert mindestens 5 Seiten. Siehe Seiten hinzufügen und organisieren.

4. Das Design festlegen#

   Öffne <b>Erscheinungsbild</b>, um das Logo, die Markenfarbe, den Website-Stil, die Schriftarten und die Kopfzeile deiner Startseite zu ändern. Eine Live-Vorschau zeigt jede Änderung. Richte die Menüs für Kopf- und Fußzeile unter <b>Navigation</b> ein. Siehe Das Design einer Dokumentations-Website anpassen und Kopf- und Fußzeile einer Dokumentations-Website einrichten.

5. KI-Assistent aktivieren#

   Der Assistent ist auf einer neuen Website standardmäßig deaktiviert. Gehe zu <b>Einstellungen → KI-Assistent</b>, aktiviere <b>Assistenten anzeigen</b>, wähle aus, was passieren soll, <b>Wenn er nicht antworten kann</b>, und klicke auf <b>Speichern</b>. Er antwortet nur auf Basis deiner veröffentlichten Seiten und listet seine Quellen auf. Antworten kosten keine Credits; dein Plan beinhaltet eine monatliche Anzahl an Antworten (300 im Free-Plan). Siehe Den Assistenten für die Dokumentations-Website einrichten.

6. Zugriff festlegen#

   Jede Website ist standardmäßig öffentlich. Um sie privat zu machen, gehe zu <b>Einstellungen → Zugriff</b> und wähle <b>Passwort</b> oder <b>Anmeldung am Arbeitsbereich</b>. Private Websites erfordern den Pro-Plan oder höher. Siehe Zugriff auf eine Dokumentations-Website steuern.

7. Veröffentlichen#

   Klicke in der Kopfzeile der Website auf <b>Veröffentlichen</b>, prüfe die Liste der Änderungen und bestätige (die Schaltfläche lautet zum Beispiel <b>3 Änderungen veröffentlichen</b>). Leser sehen die neue Version innerhalb von Sekunden, und jede Version wird unter <b>Wird veröffentlicht</b> gespeichert, sodass du sie bei Bedarf rückgängig machen kannst. <b>Automatisch veröffentlichen</b> ist für neue Websites aktiviert: Sobald die Website online ist, werden gespeicherte Änderungen nach etwa zwei Minuten ohne weitere Bearbeitung live geschaltet. Siehe Eine Dokumentations-Website veröffentlichen.

8. Eigene Domain verbinden#

   Eigene Domains erfordern den Starter-Plan oder höher. Öffne <b>Domain</b>, gib eine Subdomain wie help.example.com ein und klicke auf <b>Verbinden</b>. Füge den CNAME-Eintrag, den Clevera anzeigt, bei deinem Domain-Anbieter hinzu und klicke dann auf <b>Jetzt prüfen</b>. Das Zertifikat dauert in der Regel 5–30 Minuten. Sobald der Status <b>Online</b> ist, leitet die kostenlose Adresse auf deine Domain um. Root-Domains wie example.com können nicht verbunden werden. Siehe Eine eigene Domain mit einer Dokumentations-Website verbinden.

Autopilot die Arbeit überlassen#

Ab dem Pro-Tarif kann Autopilot das Hilfe-Center für dich erstellen und pflegen. Klicke in der Seitenleiste auf Autopilot, um zu beginnen; siehe Zugriff auf Autopilot erhalten. Nur der Workspace-Inhaber oder ein Administrator kann das Build-Rezept verwenden.

Ein Hilfe-Center aus deiner App erstellen#

Klicke unter <b>Autopilot</b> auf das Rezept <b>Ein Hilfe-Center aus meiner App erstellen</b> oder gib "Erstelle mir ein Hilfe-Center" unter <b>Was soll Autopilot tun?</b> ein. Der Clevera-Agent zeigt eine Einrichtungskarte an. Klicke auf <b>Details ausfüllen</b>, füge deine <b>Website</b> und <b>App-Adresse</b> hinzu, wähle eine Anmeldemethode und lege die Sprachen der Website fest.

Wähle unter <b>Bestehendes Hilfe-Center</b> die Option <b>Neu starten</b> oder <b>Importieren</b> und wähle Intercom, Zendesk, Help Scout, GitBook, ReadMe, Mintlify, Document360, Docusaurus oder <b>Eine andere Dokumentations-Website</b>. Der Import liest nur öffentliche Seiten und ist kostenlos. Notion und Confluence werden über die Website-Einstellungen importiert, sobald diese existiert.

Die Aufgabe läuft in vier Schritten ab: <b>Marke</b>, <b>Website und Videos</b>, <b>Artikel</b> sowie <b>Überprüfen und veröffentlichen</b>. Die Planung ist kostenlos. Du siehst den Plan und die benötigten Credits für jeden Schritt; es wird nichts ausgeführt, bevor du auf <b>Ausführen</b> klickst. Ein typischer Build kostet 240–560 Credits und dauert 1–3 Stunden. Clevera veröffentlicht die Website niemals automatisch für dich: Im letzten Schritt wählst du die Artikel aus und klickst auf <b>Veröffentlichen</b>. Siehe Ein Hilfe-Center mit Autopilot aus deiner App erstellen.

Bei Updates aktuell halten#

Sobald die Website existiert, überwacht das Rezept <b>Mein Hilfe-Center bei Updates aktuell halten</b> die Releases oder zusammengeführten Änderungen eines Repositorys, eine Changelog-Seite oder eine von dir beschriebene Änderung. Jedes Mal, wenn sich etwas ändert, prüft Clevera die betroffenen Videos und Artikel und plant die Korrekturen. Jeder Durchlauf wartet auf deine Überprüfung; ein typischer Durchlauf kostet 10–150 Credits. Siehe Dein Hilfe-Center bei Updates aktuell halten.

Verwandte Themen#