Aus einer Produktänderung einen Changelog-Eintrag erstellen und veröffentlichen

Du kannst aus einer Produktänderung einen Changelog-Eintrag für deine Kunden machen: Markiere die Änderung, verfasse den Text, speichere ihn als Entwurf und veröffentliche ihn im Changelog deines Help Centers. Dafür brauchst du die Berechtigung, den Changelog zu bearbeiten, und die Änderung muss zu einem Help Center gehören. Ohne Bearbeitungsrechte kannst du Einträge nur lesen. Die Schaltflächen „Was ist das?", „Publish" und „Discard" werden dir nicht angezeigt.

Änderung für den Changelog markieren

1. Änderung öffnen
   Öffne „Changes" und wähle in einer beliebigen Ansicht die Änderung aus, die du ankündigen möchtest. Die Aktionsleiste der Änderung befindet sich unten im Detailbereich.

2. Auf das Megafon klicken
   Die erste Schaltfläche in der Aktionsleiste ist rund und zeigt ein Megafon-Symbol. Wenn du den Mauszeiger über die Schaltfläche einer noch nicht markierten Änderung bewegst, wird „Add to the changelog" angezeigt. Klicke darauf, um für diese Änderung einen Entwurf im zugehörigen Help Center zu erstellen. Während die Markierung gespeichert wird, dreht sich die Schaltfläche. Anschließend bleibt sie gedrückt und zeigt ein kleines Häkchen. Du kannst die Schaltfläche nicht verwenden, solange für die Änderung gerade eine andere Aktion ausgeführt wird.

   Falls du versehentlich darauf geklickt hast, klicke erneut auf das Megafon, solange die Änderung die einzige Quelle im Entwurf ist. Dadurch wird die Markierung entfernt.

Eintrag verfassen

3. Eintrag öffnen
   Öffne den Entwurf auf eine von zwei Arten:

   • Klicke bei einer bereits markierten Änderung erneut auf das Megafon.
   • Klicke in der linken Spalte von „Changes" auf „Changelog" und wähle den Eintrag im Bereich „Drafts" aus. Wenn in der Liste „Select a Help Center to view its changelog" angezeigt wird, wähle zuerst im Filter ein Help Center aus.

   Der Eintrag wird als Karte mit einer Aktionsleiste darunter geöffnet. Wenn auf der Karte „Writing the customer text…" angezeigt wird, warte kurz. Du kannst die Felder erst bearbeiten, wenn der Text erstellt wurde.

4. Kategorie und Format auswählen
   Wähle in der Auswahl oben auf der Karte die Kategorie aus, die am besten beschreibt, was sich für Leser geändert hat. Wähle rechts neben dieser Auswahl ein Format aus. Bewege den Mauszeiger über die einzelnen Formate, um zu sehen, wofür sie gedacht sind. Kategorie und Format gelten für den gesamten Eintrag, nicht für einzelne Sprachen.

5. Überschrift und Text verfassen
   Gib in „Heading" den Titel ein, den Leser sehen sollen. Verfasse den Eintragstext in „Body" (Platzhalter: „What changed for the reader."). Das Textfeld für den Inhalt ist ein Markdown-Editor mit grundlegenden Formatierungsoptionen wie Fettdruck, Kursivschrift und kleinen Überschriften. Du kannst den Eintrag erst veröffentlichen, wenn beide Felder ausgefüllt sind. Bis dahin wird in der Aktionsleiste „Needs a heading and a body." angezeigt.

6. Datum im Feed festlegen
   Im Bereich „Feed date" legst du fest, unter welchem Tag der Eintrag aufgeführt wird. Standardmäßig ist es der Tag der Änderung („Listed under , the day of the change"). Klicke auf eine der folgenden Optionen, um das Datum zu ändern:

   • „Use the publish day"
   • „Pick a day": Öffnet ein Datumsfeld. So kannst du ein früheres Datum für den Eintrag festlegen oder mehrere Einträge einem Tag zuordnen.
   • „Use the day of the change": Wechselt zurück zur Standardeinstellung.

   Ein Eintrag mit einem früheren Datum erscheint unter dem ausgewählten Tag und steht daher möglicherweise nicht ganz oben im Changelog.

7. Quellen prüfen
   Sieh dir den Bereich „Sources" unterhalb der Karte an. Dort findest du einen Link zu der Änderung, aus der der Text erstellt wurde. Wenn sich eine Quelle inzwischen geändert hat, wird daneben eine Warnung angezeigt, zum Beispiel „Source changed since the text was written.". Du kannst die Änderung von dort aus öffnen und vergleichen.

8. Entwurf speichern
   Nachdem du Änderungen vorgenommen hast, zeigt die Aktionsleiste „Unsaved edits" an, und die primäre Schaltfläche lautet „Was ist das?" („Keeps the draft. Nothing reaches readers."). Klicke auf „Was ist das?". Der Status ändert sich zu „Draft, not published" und die primäre Schaltfläche wird zu „Publish". Falls das Speichern fehlschlägt, erklärt eine Benachrichtigung mit dem Hinweis „Saving failed", warum.

   Wenn du deine Änderungen stattdessen verwerfen möchtest, klicke auf „Discard" und bestätige mit „Discard unsaved edits?". Wenn du die Seite mit nicht gespeicherten Änderungen verlässt, erscheint dieselbe Frage mit den Optionen „Discard and leave" und „Keep editing".

Eintrag veröffentlichen

9. Auf „Publish" klicken
   Klicke auf „Publish". Danach können Leser den Eintrag sehen. Alle anderen Sprachen werden im Hintergrund übersetzt. Wenn es Warnungen zu Quellen gibt, werden sie zuerst im Dialog „Publish with warnings?" aufgelistet. Klicke zur Bestätigung auf „Publish".

   Nach der Veröffentlichung lautet der Status „Published" und zeigt den Zeitpunkt an. Der Eintrag wird in der Changelog-Liste von „Drafts" zu „Published" verschoben. Wenn jemand den Eintrag an anderer Stelle geändert hat, nachdem du ihn geöffnet hast, schlägt die Veröffentlichung fehl und eine Benachrichtigung mit dem Hinweis „Publishing failed" wird angezeigt. Lade den Eintrag neu, um die aktuelle Version zu erhalten, und versuche es dann erneut.

Veröffentlichte Einträge erscheinen nur dann im Changelog-Tab des Help Centers, wenn das Changelog-Add-on des Help Centers aktiviert ist. Ist es deaktiviert, wird in der Changelog-Liste „Readers can't see this changelog yet" mit dem Link „Turn it on in Add-ons" angezeigt. Dein Eintrag ist gespeichert und veröffentlicht, aber Leser können ihn erst sehen, wenn das Add-on aktiviert ist.