Cả cuốn sách được chia thành nhiều file, mỗi file được chia thành nhiều phần nhỏ, mỗi phần chỉ khoảng 2-3 đoạn văn. Việc chia nhỏ thế này khiến việc dịch và review không lấy quá nhiều thời gian của một người.
Các bước dịch như sau:
Tới tab issue, tìm xem issue nào chưa có người dịch, tức cột "Assignee" còn trống như trong hình dưới đây:
Giả sử bạn chọn issue ở hàng có mũi tên đỏ, tương ứng với file chapter_appendix_math/single-variable-calculus_vn.md, phần 5.
Nhớ số issue (ở ví dụ này là 393 trong phần khoanh đỏ) để dùng ở bước 7.
Trước khi thực hiện việc dịch chương này, bạn cần tự "Assign" issue này cho mình để tránh trường hợp có nhiều người cùng làm một việc một lúc.
Nếu bạn chưa là collaborator của repo này, bạn sẽ không thể tự "Assign". Bạn cần để lại comment vào trong issue đó và cc @duythanhvn hoặc @tiepvupsu. Chúng tôi sẽ assign issue đó cho bạn.
Sau khi vào file tương ứng, ở ví dụ này là chapter_appendix_math/single-variable-calculus_vn.md, bạn click vào nút "Edit" hình chiếc bút chì để bắt đầu tìm phần cần dịch.
Mỗi phần được bắt đầu bởi dòng:
<!-- ===================== Bắt đầu dịch Phần x ==================== -->
như trong hình:
chúng ta cần dịch từ sau dòng này đến trước dòng
<!-- ===================== Kết thúc dịch Phần x ==================== -->
tương ứng.
Khi dịch, bạn tìm các dòng dạng:
## *dịch tiêu đề phía trên*
*dịch đoạn phía trên*
và chỉ chỉnh sửa các dòng này.
Một vài quy tắc dịch:
- Không dịch các danh từ riêng
- Trong một đoạn, mỗi câu dịch nên để riêng một dòng (xem dòng 268, 269, 270 trong hình ví dụ ở Bước 4).
- Không dịch code
- Không nhất thiết phải dừng từng từ từng câu nhưng phải dịch đúng ý.
- Các thuật ngữ cần được dịch một cách nhất quán
- Nếu một thuật ngữ chưa có trong bảng thuật ngữ, bạn có thể đề xuất một cách dịch bằng cách tạo một PR mới
Nếu đây là lần đầu tiên bạn đóng góp vào file này, bạn cần kéo xuống cuối file và điền tên mình vào mục "Những người thực hiện" và mục tương ứng. Mục này nhằm ghi nhận đóng góp của bạn.
Lưu ý: Tên bạn sẽ chỉ xuất hiện trên trang web chính thức nếu Pull Request bạn tạo được merged sau khi trả lời các phản biện.
Sau khi dịch lần đầu xong phần của mình, bạn cần kéo xuống cuối trang để "Commit changes". Trước khi click vào nút "Commit changes", bạn cần đặt tiêu đề cho commit, cũng là tiêu đề cho Pull Request bạn sắp tạo. Tiêu đề này giống với tiêu đề trong Issue bạn nhận ban đầu (chỉ cần copy paste là được).
Click "Commit changes".
Sau khi click "Commit changes", trang tạo Pull Request sẽ tự động mở ra. Bạn chỉ cần điền số issue tương ứng, trong ví dụ này là 393, vào sau cụm "Close#" như trong hình. Lưu ý không có dấu cách giữa # và số issue. Việc này sẽ giúp issue tự động được đóng sau khi Pull Request này được merged.
Click "Create pull request".
Trong trường hợp bạn chưa hoàn thành nội dung cần dịch, hoặc nội dung này bạn mong muốn tự chỉnh sửa để hoàn thiện hơn, bạn hãy lựa chọn tạo một "Draft Pull Request" theo hướng dẫn ở hình dưới.
Sau khi hoàn thiện nội dung, bạn có thể chọn Ready for review để Pull request này được nhóm tiến hành review.
Cuối cùng, bạn kiểm tra checklist và click vào các ô tương ứng đã hoàn thành như hình dưới đây.
Trong ví dụ này, phần đã nhận chưa được dịch trọn vẹn nên chưa có dấu tick.
Nếu là lần đầu nộp Pull Request, bạn sẽ nhận được vô số bình luận/gợi ý từ các reviewer. Việc này là hoàn toàn bình thường, những người làm việc trong nhóm này thường có rất nhiều góp ý xây dựng giúp bản dịch được trọn vẹn và nhất quán với các phần khác. Họ sẽ gợi ý bạn cách sửa, bạn có thể chấp nhận gợi ý hoặc phản hồi lại các phản hồi đó.
Cuối cùng, nếu bạn thấy phần phản hồi nào hữu ích, bạn có thể điền tên user tương ứng vào dưới tên bạn ở mục "Những người thực hiện". Cả người dịch và người review đều xứng đáng được ghi công.
Nếu bạn chưa biết tên đầy đủ của những người đóng góp, bạn có thể xem danh sách Contributors tại đây. Nếu bạn chưa thấy tên mình tại đây, hãy tạo một Issue mới để được bổ sung.
Cảm ơn đóng góp của bạn.
Thân mến,
Nhóm dịch thuật Machine Learning Cơ Bản