Biên Soạn bản Hướng Dẫn Sử Dụng (Editing the Manual)

Bạn có thể sửa đổi bản hướng dẫn sử dụng bằng việc biên soạn các văn bản địa phương. Những tập tin này sẽ được đồng bộ hóa với các bản ở trên mạng thông qua một kho lưu trữ, dựa vào cái này, máy chủ sẽ cập nhật bản hướng dẫn sử dụng trực tuyến.

Bản Hướng Dẫn Sử Dụng được viết trong ngôn ngữ đánh dấu tái Cấu Trúc Văn Bản (reStructuredText)), (viết tắt là RST), và có thể biên soạn dùng một trình biên soạn văn bản đơn thuần nào đó. Để xem trước cục bộ tại máy của mình thì bạn có thể chuyển đổi (build) các tập tin mã nguồn của bản Hướng Dẫn Sử Dụng từ định dạng RST sang các trang mạng HTML.

Cập Nhật (Update)

Trước tiên thì hãy đảm bảo rằng bản sao địa phương của bản hướng dẫn sử dụng của bạn đã được cập nhật với những thay đổi gần đây nhất từ kho lưu trữ trực tuyến bằng cách sử dụng:

make update

Viết Tài Liệu (Writing)

Bây giờ, bạn có thể biên soạn các tập tin tài liệu, tức là các tập tin ".rst" bên trong thư mục '"thủ công"' bằng cách sử dụng trình biên soạn văn bản lựa chọn của mình.

Hãy đọc bản Hướng Dẫn về Phong Cách Viết (Writing Style Guide) để biết được các quy ước và Hướng Dẫn về Kiểu Cách của Dấu Đánh (Markup Style Guide) để tìm hiểu cách viết bằng ngôn ngữ đánh dấu reStructuredText.

Chúc bạn viết vui vẻ!

Những Thay Đổi Lớn Hơn (Bigger Changes)

If you are going to add or overhaul a section, be sure to check carefully that it does not already exist. In some places, the docs are so disorganized that sections may be duplicated or in a strange location. In the case that you find a duplicate or out of place section, create an issue explaining the issue, and optionally include a revision (actual changes).

Trước khi bạn thực hiện bất kỳ một biên soạn có nhiều phức tạp và khó lý giải nào đó (ví dụ, di chuyển các thư mục từ chỗ nọ sang chỗ kia) thì bạn nên kiểm tra và xác minh các thay đổi của mình với một người bảo trì bản hướng dẫn sử dụng trước đi đã, xem xem sự đóng góp của bạn có đi đôi với đường lối của cộng đồng trong bản hướng dẫn hay không. Điều này sẽ đảm bảo sự tận dụng tốt nhất thời gian và lòng tốt của bạn, vì nếu không, rất có thể vì một số lý do nào đó, những thay đổi của bạn sẽ gây xung đột với bản hiện tại và hoặc là bị từ chối, hoặc là cần phải tốn kém thời gian để xem xét lại. Ví dụ, một người khác có thể đã làm việc trên phần mà bạn muốn thay đổi, hoặc phần này có thể đã được lên kế hoạch để xóa hoặc đi hoặc để cập nhật theo một kế hoạch đã được Blender đặt ra trước đây, chẳng hạn.

Sự Liên Lạc (Communicating) sớm và thường xuyên là chìa khóa để có một môi trường sản xuất hiệu quả, hòng tránh lãng phí nỗ lực của mọi người và hòng đạt được một bản hướng dẫn sử dụng Blender tốt hơn.

Yêu Cầu Giúp Đỡ/Trả Lời (Getting Help/Answers)

Nếu bạn có nghi ngờ gì về một chức năng nào mà bạn muốn viết tài liệu về nó thì bạn nên đặt câu hỏi của mình với các nhà phát triển Blender chịu trách nhiệm cho khu vực đó, hoặc đặt câu hỏi trên kênh hỗ trợ người dùng không chuyên tại "#docs" hoặc "#blender-coders", dùng kênh Chat.

Blender itself has a system of module owners with developer and artist members who are responsible for the design and maintenance of the assigned Blender areas. See the module pages for more information.

Xem Trước (Preview)

Để xem các thay đổi của mình thì bạn hãy xây dựng bản hướng dẫn sử dụng theo sự hướng dẫn ở đây (as instructed). Hãy nhớ rằng bạn còn có thể chỉ xây dựng chương mà bạn vừa biên soạn xong mà thôi, để xem nó một cách nhanh chóng nữa. Mở các tập tin .html được tạo bên trong thư mục build/html, bằng một trình duyệt mạng của bạn, hoặc làm tươi mới lại trang mà bạn đang xem, nếu bạn đã mở nó rồi.

Tải các Thay Đổi lên (Upload)

Khi bạn đã hài lòng với các thay đổi của mình, bạn có thể tải chúng lên, để chúng hiện hữu trong bản hướng dẫn trực tuyến. Thực hiện điều này bằng cách, trước tiên, gửi các bản chỉ chứa các patches, hòng dùng nó để chắp vá bản hiện tại, để một người nào đó có thể xét duyệt các thay đổi, và phản hồi ý kiến của họ đối với những sửa chữa của bạn. Sau đó, bạn có thể trực tiếp chuyển giao các thay đổi của mình vào kho chứa. Quá trình này sẽ được miêu tả chi tiết trong phần tiếp theo.