GitHub

Alle Arbeitsabläufe beginnen und enden auf der GitHub-Ebene, wo das Haupt-Repository für ein Adobe-Dokumentationsprojekt gespeichert wird. Die Kopien, die Mitarbeiter für ihre eigene Verwendung erstellen, werden auf mehrere Computer verteilt. Diese Kopien werden schließlich wieder mit dem GitHub-Haupt-Repository des Projekts abgestimmt.

Verzeichnisorganisierung

Die Standard-/Hauptverzweigung eines Projekts liefert die aktuelle Version eines Inhalts für das Projekt. Der Inhalt in der Hauptverzweigung – sowie der daraus erstellten Verzweigungen – ist ebenso angeordnet wie die Artikelthemen. Unterverzeichnisse werden zum Organisieren von Inhalts- und Bildassets verwendet.

In der Regel befindet sich ein help-Hauptverzeichnis im Stamm des Repositorys. Das Artikelverzeichnis enthält eine Reihe von Unterverzeichnissen. Artikel in den Unterverzeichnissen werden als Markdown-Dateien formatiert, die eine .md-Erweiterung verwenden.

Im Stamm dieses Verzeichnisses finden Sie allgemeine Artikel, die sich auf den Gesamtdienst oder das gesamte Produkt beziehen. In der Regel können Sie dann eine weitere Reihe von Unterverzeichnissen finden, die den Funktionen/Diensten oder allgemeinen Szenarien entsprechen.

Assetverzeichnis

Benutzerhandbuch-Verzeichnisse enthalten /assets-Unterverzeichnisse für Bilddateien, auf die in einem Verzeichnis verwiesen wird.

Pull-Anfragen

Eine Pull-Anfrage bietet Mitarbeitern eine praktische Möglichkeit, einen Satz von Änderungen vorzuschlagen, die auf die Standardverzweigung angewendet werden. Die Änderungen (auch als Zusagen bezeichnet) werden in der Verzweigung eines Mitarbeiters gespeichert. GitHub kann so zuerst die Auswirkungen der Zusammenführung in der Standardverzweigung modellieren. Eine Pull-Anfrage dient auch als Mechanismus, um Mitarbeitern Feedback aus einem Build-/Validierungsprozess durch den Pull-Anfrageprüfer bereitzustellen und so potenzielle Probleme oder Fragen zu klären, bevor die Änderungen in der Standardverzweigung zusammengeführt werden.

Je nach Größe der Änderungen, die Sie vorschlagen möchten, gibt es zwei Möglichkeiten, etwas durch Pull-Anfragen beizutragen: Wir behandeln dies im Detail später im Abschnitt GitHub-Arbeitsablauf in diesem Handbuch.

recommendation-more-help