Zum Inhalt

Arbeiten Sie mit einem Feature-Zweig, nicht mit Ihrem main Zweig.

Bevor Sie mit der Arbeit an Ihrer Änderung beginnen, stellen Sie sicher, dass Sie einen Zweig erstellt haben. Wenn Sie Ihren Repository Fork klonen, werden Sie standardmäßig in Ihrem main-Zweig ausgecheckt. Dies ist eine direkte Kopie des BeeWare's main branch.

Sie können zwar einen Pull Request von Ihrem main einreichen, aber es ist besser, wenn Sie das nicht tun. Wenn Sie einen Pull Request einreichen, der fast richtig ist, kann das Mitglied des Kernteams, das Ihren Pull Request prüft, die notwendigen Änderungen vornehmen, anstatt eine Rückmeldung zu geben, in der um eine kleine Änderung gebeten wird. Wenn Sie jedoch Ihren Pull Request von Ihrem main einreichen, werden die Prüfer daran gehindert Änderungen vorzunehmen.

Von Ihrem Hauptzweig aus zu arbeiten, macht es auch für Sie schwierig, nachdem Sie Ihren ersten Pull Request fertiggestellt haben. Wenn Sie an einem zweiten Pull Request arbeiten wollen, brauchen Sie eine "saubere" Kopie des Hauptzweigs des Upstream-Projekts, auf der Sie Ihren zweiten Beitrag aufbauen können; wenn Sie Ihren ersten Beitrag von Ihrem main gemacht haben, haben Sie diese saubere Version nicht mehr zur Verfügung.

Stattdessen sollten Sie Ihre Änderungen in einem Funktionszweig vornehmen. Ein Funktionszweig hat einen einfachen Namen, um die Änderung zu identifizieren, die Sie vorgenommen haben. Wenn Sie zum Beispiel einen Fehler beheben, der Build-Probleme unter Windows 11 verursacht, könnten Sie einen Feature-Zweig fix-win11-build erstellen. Wenn sich Ihr Fehler auf ein bestimmtes Problem bezieht, das gemeldet wurde, ist es auch üblich, die Nummer des Problems im Zweignamen zu erwähnen (z.B. fix-1234).

Um einen fix-win11-build Funktionszweig zu erstellen, führen Sie aus:

(.venv) $ git switch -c fix-win11-build
(.venv) $ git switch -c fix-win11-build
(.venv) C:\...>git switch -c fix-win11-build