Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Dokumentations-Websites: hier beginnen

Für Produktdokumentation, Wissensdatenbanken und Handbücher mit Exponential: Struktur, Prüf- und Freigabezustände, Suche, Übersetzungen, Exporte als PDF und E-Book und die Routinen, die Dokumentation korrekt halten.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/customers/types/documentation-site-start-here.md

On this page

This page is a translation. Read the English original

Dokumentations-Websites: hier beginnen

Dokumentation wird gelesen, wenn jemand sofort eine Antwort braucht. Eine Dokumentations-Website wird an zwei Dingen gemessen: ob die Antwort in Sekunden zu finden ist und ob sie noch stimmt. Alles andere (das Design, die Zahl der Seiten) kommt danach. Exponential passt gut zu Dokumentation, weil seine Inhalte strukturiert sind: Eine Seite hat Felder, einen Platz in einem Baum, Versionen, Übersetzungen und Beziehungen, sodass ein Handbuch über Jahre wachsen kann, ohne zu einem Haufen loser Seiten zu werden.

Diese Seite ist für die Dokumentationsleitung, die technischen Autoren und die Produktverantwortlichen, die für die Dokumentation einstehen.

Was Exponential einer Dokumentations-Website bietet

BedarfWas ihn trägtWo es erklärt wird
Seiten in einer klaren HierarchieDer Inhaltsbaum und Container-Klassen; die Demo-Installation hat eine Klasse Documentation pageDen Inhaltsbaum strukturieren
Prüfung vor der FreigabeEntwürfe, Freigabe-Workflows, ObjektzuständeFreigabe und Prüfung, Objektzustände
Wissen, was eine Seite vorher gesagt hatVersionskontrolleVeröffentlichen und Versionen
Antworten schnell findenDie eingebaute Suchmaschine, oder Solr über eZ Find, wo installiertWebsite-Suche, Suche mit eZ Find und Solr
Dieselbe Seite in mehreren SprachenÜbersetzungen jedes ElementsSprachen, Übersetzungsroutine
Druckbare HandbücherDer PDF-Export (Setup > PDF export)PDF-Export
Links, die nicht kaputtgehenURL-Aliase und Weiterleitungen, LinkprüfungenURLs, Weiterleitungen und verschobene Seiten

Ein ausgearbeitetes Modell: die Hilfe, die Sie gerade lesen

Die Hilfe der Administration von Exponential ist selbst eine Dokumentations-Website, und sie zeigt die Muster. Seit 6.0.15 können Hilfethemen, Handbücher, Abbildungen und das Glossar als Inhalte der Website gepflegt werden: acht Klassen in der Klassengruppe „Help“ (Handbuch, Kapitel, Konzept, Aufgabe, Referenz, Fehlerbehebung, Abbildung, Glossareintrag), eine Gruppe von Objektzuständen help_status mit den Zuständen Draft, Review und Released, die Rollen „Help editor“ und „Help release“ und ein Export eines Handbuchs als EPUB oder PDF (doc/eng-us/features/6.0/help-content.md). Eine Demo-Installation hat diese Klassen.

Sie müssen diese Klassen nicht für die Dokumentation Ihres eigenen Produkts verwenden, aber das Modell lohnt sich zur Nachahmung:

  • Thementypen (ein Konzept erklärt, eine Aufgabe gibt Schritte vor, eine Referenz listet Fakten, eine Fehlerbehebung geht von einem Symptom aus), damit Autoren wissen, wofür eine Seite da ist;
  • ein Freigabezustand, getrennt vom Veröffentlichen, damit eine Seite für Prüfende sichtbar sein kann, bevor sie freigegeben ist;
  • zwei Rollen: Personen, die schreiben, und Personen, die freigeben;
  • ein Glossar, damit ein Begriff auf jeder Seite dasselbe bedeutet.

Fragen Sie Ihren Partner, ob die Klassen Ihrer Website einem solchen Modell folgen und was nötig wäre, wenn nicht (Änderungsanfragen).

Dokumentation korrekt halten

  • Mit jedem Produkt-Release: Listen Sie die Seiten auf, die das Release ändert, aktualisieren Sie sie als Entwürfe, lassen Sie sie prüfen und geben Sie sie am Release-Tag frei (Zeitgesteuertes Veröffentlichen).
  • Jeden Monat: Sehen Sie sich an, wonach Leser suchen und was sie nicht finden (Website-Suche und wonach Besucher suchen): Jede erfolglose Suche ist eine fehlende Seite oder ein fehlendes Wort.
  • Jedes Quartal: ein Inhalts-Audit: Seiten, die niemand liest, Seiten für Produkte, die es nicht mehr gibt, und kaputte Links.

Tipp Löschen Sie nie eine Dokumentationsseite, die Menschen als Lesezeichen gespeichert haben könnten. Verschieben Sie sie, halten Sie ihre alte Adresse mit einer Weiterleitung funktionsfähig, oder ersetzen Sie ihren Text durch einen Verweis auf die Seite, die übernommen hat.

Ihr nächster Schritt

Folgen Sie dem Lesepfad für Dokumentations-Websites. Dokumentation in mehreren Sprachen sollte den Lesepfad für mehrsprachige Websites ergänzen.

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x