Hãy làm việc trên nhánh tính năng, không phải nhánh main của bạn¶
Trước khi bắt đầu thực hiện thay đổi, hãy đảm bảo rằng bạn đã tạo một nhánh.
Theo mặc định, khi bạn sao chép (clone) bản sao (fork) của kho lưu trữ, bạn sẽ
được chuyển đến nhánh main của kho lưu trữ đó. Đây là bản sao chính xác của
nhánh BeeWare Docs Tools trong kho lưu trữ main.
Mặc dù bạn có thể gửi yêu cầu pull từ nhánh main của mình, nhưng tốt nhất là
bạn không nên làm như vậy. Nếu bạn gửi một yêu cầu pull gần như hoàn chỉnh,
thành viên nhóm cốt lõi chịu trách nhiệm xem xét yêu cầu pull của bạn có thể sẽ
trực tiếp thực hiện các thay đổi cần thiết, thay vì đưa ra phản hồi yêu cầu bạn
chỉnh sửa một số chi tiết nhỏ. Tuy nhiên, nếu bạn gửi yêu cầu pull từ nhánh
main của mình, những người xem xét sẽ không thể thực hiện bất kỳ chỉnh sửa
nào.
Việc làm việc trên nhánh chính cũng sẽ gây khó khăn cho bạn sau khi bạn hoàn
thành yêu cầu pull đầu tiên. Nếu bạn muốn thực hiện yêu cầu pull thứ hai, bạn sẽ
cần có một bản sao "sạch" của nhánh chính trong dự án nguồn để làm cơ sở cho
đóng góp thứ hai của mình; nếu bạn đã thực hiện đóng góp đầu tiên từ nhánh
main, bạn sẽ không còn bản sao sạch đó nữa.
Thay vào đó, bạn nên thực hiện các thay đổi trên một chi nhánh tính năng. Chi
nhánh tính năng có tên đơn giản để xác định thay đổi mà bạn đã thực hiện. Ví dụ:
nếu bạn đang sửa một lỗi gây ra sự cố xây dựng trên Windows 11, bạn có thể tạo
một nhánh tính năng fix-win11-build. Nếu lỗi của bạn liên quan đến một vấn đề
cụ thể đã được báo cáo, việc tham chiếu số vấn đề đó trong tên nhánh cũng là
điều phổ biến (ví dụ: fix-1234).
Để tạo nhánh tính năng fix-win11-build, hãy chạy lệnh:
(.venv) $ git switch -c fix-win11-build
(.venv) $ git switch -c fix-win11-build
(.venv) C:\...>git switch -c fix-win11-build