Changelog-Eintrag vorbereiten und veröffentlichen

Du kannst einen Changelog-Eintrag auf zwei Arten erstellen: Markiere eine Produktänderung und wandle sie in einen Entwurf um oder schreibe einen Eintrag von Grund auf neu. In beiden Fällen bearbeitest und veröffentlichst du den Entwurf auf dieselbe Weise. Du brauchst die Berechtigung, den Changelog zu bearbeiten, und der Eintrag muss zu einem Help Center gehören. Ohne Bearbeitungsrechte werden dir die Einträge schreibgeschützt angezeigt, ohne "Save", "Publish" oder "Discard".

Methode A: Eine Produktä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 eine noch nicht markierte Änderung bewegst, wird "Add to the changelog" angezeigt. Klicke darauf, um einen Entwurf für den Changelog des zugehörigen Help Centers 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, während 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 schreiben

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. Du kannst die Felder erst bearbeiten, wenn der Text erstellt wurde.

4. Kategorie und Format auswählen
   Wähle oben auf der Karte aus den angezeigten Optionen die Kategorie aus, die beschreibt, was sich für die Leser geändert hat. Wähle rechts daneben ein Format aus. Bewege den Mauszeiger über die einzelnen Formatoptionen, 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 schreiben
   Gib unter "Heading" den Titel ein, den die Leser sehen sollen. Schreibe den Text des Eintrags in "Body" (Platzhalter: "What changed for the reader."). Im Markdown-Editor kannst du einfache Formatierungen wie Fettdruck, Kursivschrift und kleine Überschriften verwenden. 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 Datum der Eintrag aufgeführt wird. Standardmäßig ist das der Tag der Änderung ("Listed under , the day of the change"). Ändere das Datum, indem du eine der folgenden Optionen auswählst:

   • "Use the publish day"
   • "Pick a day": Öffnet ein Datumsfeld, in dem du den Eintrag rückdatieren oder mehrere Einträge unter einem Datum zusammenfassen kannst.
   • "Use the day of the change": Wechselt zurück zur Standardeinstellung.

   Ein rückdatierter Eintrag erscheint unter dem ausgewählten Datum und wird daher möglicherweise nicht ganz oben im Changelog angezeigt.

7. Quellen überprüfen
   Überprüfe den Abschnitt "Sources" unter der Karte. Dort findest du einen Link zu der Änderung, auf deren Grundlage der Text geschrieben 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
   Sobald du Änderungen vorgenommen hast, wird in der Aktionsleiste "Unsaved edits" angezeigt und die primäre Schaltfläche wechselt zu "Save" ("Keeps the draft. Nothing reaches readers."). Klicke auf "Save". Der Status ändert sich zu "Draft, not published" und die primäre Schaltfläche wird zu "Publish". Wenn das Speichern fehlschlägt, erklärt eine Toast-Meldung mit "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 ungespeicherten Ä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". Die Leser sehen nun den Eintrag, und 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 wird als Status "Published" mit der Uhrzeit angezeigt. Außerdem wird der Eintrag in der Changelog-Liste von "Drafts" nach "Published" verschoben. Wenn jemand den Eintrag an anderer Stelle geändert hat, seit du ihn geöffnet hast, schlägt die Veröffentlichung fehl und eine Toast-Meldung mit "Publishing failed" wird angezeigt. Lade den Eintrag neu, um die aktuelle Version zu laden, und versuche es dann erneut.

Veröffentlichte Einträge werden im Changelog-Tab des Help Centers nur angezeigt, 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 die Leser sehen ihn erst, wenn das Add-on aktiviert wird.