Was sind einige Beispiele für gängige Praktiken zur Benennung von Git-Zweigen?

Question

Ich verwende seit einigen Monaten ein lokales Git-Repository, das mit dem CVS-Repository meiner Gruppe zusammenarbeitet. Ich habe eine fast schon neurotische Anzahl von Zweigen erstellt, von denen die meisten glücklicherweise wieder in meinen Stamm eingeflossen sind. Aber die Namensgebung fängt an, ein Problem zu werden. Wenn ich eine Aufgabe habe, die sich leicht mit einem einfachen Label benennen lässt, aber ich erledige sie in drei Phasen, die jeweils ihre eigene Verzweigung und Zusammenführungssituation beinhalten, dann kann ich den Namen der Verzweigung jedes Mal wiederholen, aber das macht die Geschichte ein wenig verwirrend. Wenn ich in den Namen spezifischer werde, mit einer separaten Beschreibung für jede Stufe, dann werden die Zweignamen lang und unhandlich.

Ich habe beim Durchsehen alter Threads hier gelernt, dass ich anfangen könnte, Zweige mit einem / im Namen zu benennen, z. B. Thema/Aufgabe oder so ähnlich. Vielleicht fange ich damit an und schaue, ob es hilft, die Dinge besser zu organisieren.

Was sind die besten Praktiken für die Benennung von Git-Zweigen?

Bearbeiten: Niemand hat tatsächlich irgendwelche Namenskonventionen vorgeschlagen. Ich lösche Zweige, wenn ich mit ihnen fertig bin. Ich habe nur zufällig mehrere davon, weil das Management ständig meine Prioritäten ändert :) Ein Beispiel dafür, warum ich mehr als einen Zweig für eine Aufgabe brauche: Nehmen wir an, ich muss den ersten einzelnen Meilenstein der Aufgabe an das CVS-Repository der Gruppe übergeben. Zu diesem Zeitpunkt würde ich aufgrund meiner unvollkommenen Interaktion mit CVS diese Übergabe durchführen und dann den Zweig löschen. (Ich habe zu viele seltsame Interaktionen mit CVS erlebt, wenn ich versuche, denselben Zweig zu diesem Zeitpunkt weiter zu verwenden).

Answer 1

Beachten Sie, wie in der e703d7 übergeben o Übergabe b6c2a0d (März 2014), jetzt Teil von Git 2.0, finden Sie eine weitere Namenskonvention (die Sie auf Zweige anwenden können).

"Wenn Sie ein Leerzeichen brauchen, verwenden Sie einen Bindestrich" ist eine seltsame Art zu sagen, dass Sie kein Leerzeichen verwenden dürfen.
Da in den Beschreibungen der Befehlszeilen in der Regel gestrichelte Mehrfachwörter verwendet werden, sollten Sie an diesen Stellen keine Leerzeichen verwenden.

Ein Zweigname darf keine Leerzeichen enthalten (siehe " Welche Zeichen sind im Namen einer Verzweigung unzulässig? " und git check-ref-format Manpage ).

Für jeden Zweignamen, der durch einen Mehrwortausdruck dargestellt werden würde, muss also ein ' - ' (Bindestrich) als Trennzeichen ist eine gute Idee.

Answer 2

Weiterverfolgung von farktronix's Vorschlag Wir haben Jira-Ticketnummern für ähnliche Zwecke in Mercurial verwendet, und ich plane, sie auch für Git-Zweige zu verwenden. Aber ich denke, die Ticketnummer selbst ist wahrscheinlich eindeutig genug. Es könnte zwar hilfreich sein, ein beschreibendes Wort im Zweignamen zu haben, wie farktronix bemerkte, aber wenn man oft genug zwischen Zweigen wechselt, möchte man wahrscheinlich weniger eingeben. Wenn Sie den Namen des Zweigs wissen müssen, suchen Sie in Jira nach den zugehörigen Schlüsselwörtern im Ticket, wenn Sie ihn nicht kennen. Darüber hinaus sollten Sie in jedem Kommentar die Ticketnummer angeben.

Wenn Ihr Zweig eine Version repräsentiert, scheint es die übliche Konvention zu sein, das Format x.x.x (Beispiel: "1.0.0") für Zweignamen und vx.x.x (Beispiel "v1.0.0") für Tag-Namen zu verwenden (um Konflikte zu vermeiden). Siehe auch: Gibt es eine Standard-Benennungskonvention für Git-Tags?