Chắp Vá và Chuyển Giao Sửa Đổi
Đệ Trình các Chắp Vá
Một vài lần đầu thực hiện các thay đổi trong sách hướng dẫn, bạn sẽ cần phải gửi chúng đến dưới dạng một bản chắp vá để quản trị viên xét duyệt. Điều này chỉ là để nhằm đảm bảo rằng chúng tôi duy trì bản hướng dẫn sử dụng với chất lượng tốt, và rằng, bạn sẽ không vô tình mà làm hỏng bất cứ một điều gì trọng yếu, trước khi bạn trở nên thành thục với hệ thống, mà thôi.
Để gửi bản liệt kê các sửa đổi, xin hãy làm theo quy trình sau đây:
Thực hiện bất kỳ thay đổi nào mà bạn mong muốn.
Tạo bản liệt kê sửa đổi bằng cách thi hành:
svn diff > filename.diff
Điều này tạo ra một tập tin văn bản Đơn Giản, cho thấy văn bản nào đã được cho thêm vào vào, xóa hoặc thay đổi giữa các tập tin đang làm việc của bạn và kho lưu trữ trung tâm.
Nếu bạn đã kiến tạo tập tin mới, hoặc đã xóa các tập tin cũ đi, thì bạn sẽ cần phải thi hành 'svn add /path/to/file' hoặc 'svn rm /path/to/file' trước khi tạo bản liệt kê sự chênh lệch. Để xem danh sách các tập tin bị ảnh hưởng, xin hãy thi hành lệnh 'svn status'>.
Tải :abbr:`tập tin liệt kê sự khác biệt (diff file) lên đây -- Upload the diff file here. Nếu bạn chưa có tài khoản thì bạn có thể đăng ký lấy một cái -- register for one.
Sau khi gửi bản liệt kê sự khác biệt, bạn sẽ được yêu cầu "Tạo một bản Hiệu Chỉnh mới" trước khi bạn có thể thêm tiêu đề và miêu tả về các thay đổi của mình.
Xin vui lòng kiểm tra xem Dự Án Viết Tài Liệu đã được ấn định trong ô tags chưa, vì cái này sẽ nhằm thông báo cho nhóm điều hành biết về việc sửa đổi của bạn. Bạn còn có thể Liên Lạc -- contact với nhóm điều hành dùng danh sách gửi thư hoặc thông qua Trò Chuyện Trực Tuyến về Blender mữa.
Họ sẽ xem xét bản chắp vá của bạn và báo cho bạn biết là có thay đổi nào trong những sửa đổi của bạn cần phải làm lại hay không. Nếu không có vấn đề gì thì bản chắp vá của bạn sẽ được chấp thuận và sẽ được nhóm điều hành chuyển giao vào kho lưu trữ.
Ghi chú
Nếu bản chắp vá của bạn có bao gồm những thay đổi trong các hình ảnh hoặc có các hình ảnh mới bổ sung vào, thì bạn chỉ cần đính kèm chúng, khi bạn tạo bản Hiệu Chỉnh mới thôi nhé.
Các bản liệt kê sửa đổi Đơn Giản chắc chắn sẽ được chấp nhận rất nhanh. Một khi bạn đã thành thục với việc thực hiện các thay đổi và không cần sự hỗ trợ nữa, chúng tôi sẽ cắt bỏ người trung gian và cho phép bạn quyền truy cập trực tiếp để chỉnh sửa bản hướng dẫn sử dụng.
Trực Tiếp Chuyển Giao Sửa Đổi vào Kho Lưu Trữ
Khi bạn được cung cấp quyền truy cập trực tiếp để biên soạn bản hướng dẫn sử dụng thì bạn có thể khởi công chuyển giao trực tiếp thay vì phải tạo tập tin chắp vá, như trước. Việc làm này sẽ đưa thay đổi trực tiếp thẳng vào kho lưu trữ trung tâm của chúng tôi.
Bạn chỉ cần thi hành:
svn commit -m "This is what I did"
Nếu bạn không đánh '-m "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 soạn thảo văn bản riêng.
Đừng bao giờ quên thi hành lệnh cập nhật 'svn update' trước khi chuyển giao các sửa đổi vào kho dự trữ.
Sau đó, bạn sẽ phải điền tên người dùng của mình (từ developer.blender.org) và mật khẩu vào, trước khi thay đổi được chuyển giao vào kho để lưu lại.
Các tập tin đã sửa đổi của bạn sẽ được tải lên kho lưu trữ trung tâm để những người khác tiếp tục làm việc và cộng tác. Các chuyển giao về sửa đổi sẽ được lưu trữ và theo dõi trong kho Diffusion. Các thay đổi của bạn sẽ được đăng trong bản Hướng Dẫn Sử Dụng Trực Tuyến.
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ể (change) 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 việc chuyển giao thay đổi vào kho lưu trữ đã thực hiện cho mã nguồn Blender.
Ví dụ: commit 'rBM8473 <https://developer.blender.org/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 từ đị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 đó.
Song 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, với một từ tiền tố như Dọn dẹp: hoặc 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.