Kategorie, Format und Text eines Changelog-Eintrags bearbeiten

Du kannst die Kategorie, das Format, den Text, das Feed-Datum und die Übersetzungen eines beliebigen Changelog-Eintrags ändern, egal ob er noch ein Entwurf oder bereits für Leser veröffentlicht ist. Einträge bearbeiten können nur Personen in deiner Organisation, die Dokumentationsänderungen vornehmen dürfen, in der Praxis also Admins. Andere Mitglieder sehen denselben Eintrag, aber alle Felder sind deaktiviert und es gibt keine Möglichkeit, Änderungen zu speichern.

Eintrag öffnen

1. Was ist das? aufrufen
   Öffne die Seite „Changes", entweder über den Bereich „Changes" in der Hauptnavigation oder indem du in der Befehlspalette „Handoff" auswählst. Klicke unten in der linken Spalte, unterhalb einer Trennlinie, auf „Was ist das?". Die Zahl daneben zeigt an, wie viele Entwürfe noch warten.

2. Help Center auswählen
   Im Was ist das? werden nur Einträge für die Help Center angezeigt, die im Help-Center-Filter oben auf der Seite ausgewählt sind. Wenn du „Select a Help Center to view its changelog." siehst, wähle in der Filterleiste ein oder mehrere Help Center aus. Die Einträge werden dann geladen.

3. Eintrag auswählen, den du ändern möchtest
   Die Einträge sind in zwei Bereiche unterteilt: „Drafts" (nicht veröffentlicht) und „Published". In jeder Zeile siehst du die Überschrift, die Kategorie (New, Update oder Fix), das Datum, das den Lesern angezeigt wird (oder „Publish day", wenn noch kein Datum festgelegt ist), sowie eine Statusanzeige:

   • „Writing…": Der Text wird noch geschrieben.
   • „Needs a look": Der Eintrag muss von einer Person überprüft werden.
   • „Edited since publish": Ein veröffentlichter Eintrag wurde geändert, seit er live gegangen ist.

   Klicke irgendwo auf die Zeile, um den Eintrag zu öffnen.

Änderungen vornehmen

4. Kategorie und Format festlegen
   Klicke oben im Eintrag auf „New", „Update" oder „Fix", um die Kategorie zu ändern. Daneben bietet die Formatsteuerung drei Optionen:

   • Featured: Ein eigener Block im Feed mit Überschrift und Text.
   • Compact: Eine Zeile, die zusammen mit den anderen kompakten Einträgen des Tages unter ihrer Kategorie angezeigt wird.
   • One line: Ein einzelner Satz in der Tagesliste, ohne vorangestellte Überschrift.

   Mit diesen Optionen änderst du nur das Format. Nichts wird veröffentlicht, bevor du speicherst. Wurde der Eintrag aus Änderungen an der Quelle erstellt und wählst du ein anderes Format, siehst du „You changed the format to . Rewrite the text for it?". Klicke auf „Ignore", um den Text unverändert zu lassen, oder auf „Rewrite", um das Format zu speichern und den Text anhand der Quellen für dieses Format neu schreiben zu lassen.

5. Überschrift und Text bearbeiten
   Gib deinen Text in das Feld „Heading" ein und bearbeite anschließend den „Body" darunter. Die Werkzeugleiste des Textfelds bietet „Bold", „Italic", „Heading", „Bullet list", „Numbered list" und „Link". Im Textfeld werden eine Überschriftenebene, beide Listenarten und Links unterstützt. Codeblöcke, Zitate und horizontale Linien werden nicht unterstützt. Ein einfacher Zeilenumbruch bleibt ein Zeilenumbruch.

   Um einen Link hinzuzufügen, klicke auf „Link", gib die Adresse ein und klicke auf „Apply". Es funktionieren nur absolute HTTPS-Adressen. „Apply" bleibt also deaktiviert, bis du eine solche Adresse eingegeben hast. Befindet sich dein Cursor in einem bestehenden Link, kannst du auch auf „Remove link" klicken.

   Möchtest du stattdessen einen neuen Text? Öffne das Überlaufmenü des Eintrags und wähle „Rewrite from sources". Wenn du den Text bereits selbst bearbeitet hast, wirst du darauf hingewiesen, dass deine Änderungen ersetzt werden und sich nicht rückgängig machen lassen.

6. Feed-Datum anpassen
   Im Abschnitt „Feed date" legst du fest, unter welchem Tag des Was ist das? der Eintrag angezeigt wird. Über die Links daneben kannst du auswählen:

   • „Use the day of the change"
   • „Use the publish day"
   • „Pick a day", um ein Datumsfeld zu öffnen. Wenn du ein Datum festlegst, wird angezeigt, wie weit es vom heutigen Tag entfernt ist, zum Beispiel „Yesterday" oder „In 2 days".

7. Übersetzungen bearbeiten (nur veröffentlichte Einträge)
   Sobald ein Eintrag veröffentlicht ist, werden im Abschnitt „Languages" zuerst die Ausgangssprache und dann jede weitere Sprache mit ihrem jeweiligen Status aufgeführt. Öffne eine Sprachzeile, um die Überschrift und den Text der Übersetzung manuell zu lesen und zu bearbeiten. Diese Änderungen werden mit deinem nächsten Update veröffentlicht.

Änderungen speichern

8. Eintrag speichern oder aktualisieren
   Die Leiste unten im Eintrag zeigt seinen Status an, zum Beispiel „Unsaved edits." oder „Published, edited since.", und bietet die passende Schaltfläche:

   • Entwurf: Klicke auf „Save". Der Entwurf wird gespeichert und bleibt unveröffentlicht.
   • Veröffentlichter Eintrag: Klicke auf „Update". Deine Änderungen werden gespeichert und in einem Schritt veröffentlicht.

   Wenn du deine Änderungen stattdessen verwerfen möchtest, klicke auf „Discard". Wenn du versuchst, den Eintrag zu verlassen oder den Browser mit ungespeicherten Änderungen zu schließen, wirst du gefragt: „Discard unsaved edits?". Klicke auf „Keep editing", um weiterzubearbeiten, oder auf „Discard and leave", um die Änderungen zu verwerfen und den Eintrag zu verlassen.

   In zwei Fällen ist die Schaltfläche nicht verfügbar. „Needs a heading and a body." bedeutet, dass eines dieser Felder leer ist. „The text is still being written." bedeutet, dass du warten musst, bis der Text automatisch fertiggestellt wurde. Falls das Speichern fehlschlägt, wird „Saving failed" angezeigt. Dein ungespeicherter Text bleibt im Formular erhalten, sodass du es erneut versuchen kannst.

Ein Update eines veröffentlichten Eintrags ist sofort für die Leser sichtbar. Die anderen Sprachen werden im Hintergrund erneut übersetzt. Bis eine Übersetzung vorliegt, sehen Leser dieser Sprache den Text in der Ausgangssprache.