Працюйте з функціональної гілки, а не з вашої гілки main¶
Перш ніж приступити до внесення змін, переконайтеся, що ви створили гілку. За замовчуванням під час клонування форку репозиторію ви потрапляєте на гілку main. Це пряма копія гілки BeeWare репозиторію main.
Хоча ви можете надіслати запит на злиття з вашої гілки main, краще цього не робити. Якщо ви надішлете запит на злиття, який є майже правильним, член основної команди, який перевірятиме ваш запит, зможе внести необхідні зміни, замість того щоб залишати відгук із проханням про незначні виправлення. Однак, якщо ви надішлете запит на злиття з вашої гілки main, рецензенти не зможуть вносити зміни.
Робота над головною гілкою також ускладнить вам роботу після того, як ви завершите свій перший пул-реквест. Якщо ви хочете працювати над другим запитом на злиття, вам знадобиться «чиста» копія головної гілки вихідного проєкту, на якій ви зможете базувати свій другий внесок; якщо ви зробили свій перший внесок із гілки main, у вас більше немає цієї чистої версії.
Натомість вам слід вносити зміни у гілці функціональних оновлень. Гілка функціональних оновлень має просту назву, яка дозволяє ідентифікувати внесені вами зміни. Наприклад, якщо ви виправляєте помилку, яка спричиняє проблеми зі збіркою в Windows 11, ви можете створити гілку функцій fix-win11-build. Якщо ваша помилка пов’язана з конкретною проблемою, про яку вже повідомлено, також прийнято вказувати номер цієї проблеми в назві гілки (наприклад, fix-1234).
Щоб створити гілку функції fix-win11-build, виконайте наступну команду:
(.venv) $ git switch -c fix-win11-build
(.venv) $ git switch -c fix-win11-build
(.venv) C:\...>git switch -c fix-win11-build