Commit Guidelines#

Access to directly submit changes is limited to people with commit access to the repository. Once you are provided with commit access you can start committing directly instead of creating a patch file.

You can make commits from your Git client or using the Git command line tool. The following command will create a commit and send it to the central repository:

git commit -m "This is what I did"
git push

Nếu bạn không đánh '"thông điệp"' thì bạn sẽ được nhắc nhở là bạn cần phải nhập thông điệp trong một trình biên soạn văn bản riêng.

Mẹo

You should make sure you are always on the latest revision before committing. You may not be able to commit directly if there are conflicting changes in the latest revision.

To avoid this update your local repository before committing (run make update).

Xem thêm

Xin xem thêm mục Chu Kỳ Phát Hành (Release Cycle) để đọc tài liệu về phương pháp nhập kho các thay đổi vào một chi nhánh phát hành cụ thể nào đó và cách hợp nhất các thay đổi nhập kho lại làm một.

Viết Thông Điệp Miêu Tả Thay Đổi Chuyển Giao Kho Lưu Trữ Đúng Đắn (Writing a Good Commit Message)#

Khi thực hiện các thay đổi đối với bản hướng dẫn sử dụng, và những thay đổi này liên quan trực tiếp đến một commit cụ thể nào đó trong Blender thì việc giữ cho tiêu đề của commit hoàn toàn giống với commit đã thực hiện trong Blender, là một việc rất hữu dụng. Chúng tôi yêu cầu là bạn phải kèm commit hash của bản Chuyển Giao Thay Đổi vào Kho Lưu Trữ đã Thực Hiện trước đây cho Mã Nguồn Blender.

Ví dụ, commit rBM8473 chẳng hạn, commit này bao gồm một miêu tả về những thay đổi đã được thực hiện, cùng với mã băm rBa71d2b260170. Chúng ta có thể trích xuất mã băm ra khỏi địa chỉ URL cung cấp trong Tác Vụ Viết Tài Liệu cho một bản phát hành cụ thể sắp tới nào đó.


Những thay đổi có tính chất chung chung hơn khác sẽ không phải tuân theo chính sách nói đến ở trên. Điều quan trọng là phải miêu tả rõ ràng những thay đổi bạn đã thực hiện và nguyên nhân tại sao. Việc điền một tiền tố cho tiêu đề commit"Dọn Dẹp:" tiề"Sửa Chữa:" Dọn Dẹp (Cleanup): hoặc Sửa Chữa (Fix):, khi bạn thực hiện các dọn dẹp, hoặc các sửa chữa chung chung tương ứng, có thể là một điều hữu ích, nên làm.

Viết thông điệp commit tốt sẽ giúp các quản trị viên theo dõi các thay đổi đã thực hiện và đảm bảo rằng: toàn bộ các tính năng mới đã được ghi lại đường hoàng.